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_ Special Notices 








References in this publication to IBM products, programs, or services do not imply 
that IBM intends to make these available in all countries in which IBM operates. 
Any reference to an IBM product, program, or service is not intended to state or 
imply that only IBM’s product, program, or service may be used. Any functionally 
equivalent product, program, or service that does not infringe any of IBM’s intellec- 
tual property rights or other legally protectible rights may be used instead of the 
IBM product, program, or service. Evaluation and verification of operation in con- 
junction with other products, programs, or services, except those expressly desig- 
nated by IBM, are the user’s responsibility. 


IBM may have patents or pending patent applications covering subject matter in this 
document. The furnishing of this document does not give you any license to these 
patents. You can send license inquiries, in writing, to the IBM Director of Commer- 
cial Relations, IBM Corporation, Purchase, NY 10577. 


This book is intended to help the customer perform various storage management 
tasks. It contains commands to use the Data Facility Data Set Services (DFDSS) 
program. This book documents no programming interface for use by customers in 
writing programs that request or receive the services of DFDSS, except as noted 
below. 


This book also documents general-use programming interfaces and associated guid- 
ance information, product-sensitive programming interfaces associated guidance infor- 
mation, and product implementation information. 


General-use programming interfaces allow the customer to write programs that 
request or receive the services of DFDSS. 


General-use programming interface and associated guidance information 1s explicitly 
identified where it occurs, either by an introductory statement to a chapter or section 
that is entirely general-use programming interface and associated guidance 
information, or by the following marking: 


| General-Use Programming Interface 


Description of general-use programming interface and associated guidance 
information... 


ee es End of General-Use Programming Interface errs) 


Product-sensitive programming interfaces are provided to allow the customer instal- 
lation to perform tasks such as tailoring, monitoring, modification, tuning, or diag- 
nosis of this IBM product. Use of such interfaces creates dependencies on the 
detailed design or implementation of the IBM product. Product-sensitive interfaces 
should be used only for these specialized purposes. Because of their dependencies on 
detailed design and implementation, it is to be expected that programs written to 
such interfaces may need to be changed in order to run with new product releases or 
versions, or as a result of service. 


Product-sensitive programming interface and associated guidance information is explic- 
itly identified where it occurs, either by an introductory statement to a chapter or 
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section that is entirely product-sensitive programming interface and associated guid- 
ance information, or by the following marking: . 


| Product-Sensitive Programming Interface : 


Description of product-sensitive programming interface and associated guidance infor- 
mation... 


re End of Product-Sensitive Programming Interface ee: 


Product implementation information is detailed design and implementation informa- 
tion that is provided to assist customers in performing tasks such as tailoring, moni- 
toring, modifving, tuning, and diagnosing which by their nature require the use of 
information that depends on the detailed design and implementation of DFDSS. 
Product implementation information identified in this book documents no program- 
ming interfaces for use by customers in writing programs that request or receive the 
services DFDSS. . 


Warning: Do not use product implementation information for programming interface 
purposes. 


Product implementation information is explicitly identified where it occurs, either by 
an introductory statement to a chapter or section that is entirely product implementa- 
tion information, or by the following marking: 


| Product Implementation Information | 


Description of product implementation information... 


Dee sae tess End of Product Implementation Information Arch 8 a 


Note: Examples provided in this book contain sets of program statements offered to 
users as an illustration of how to obtain product services and are not to be used as 
programming interfaces. 


The following terms are trademarks of IBM and are used in this publication: 
DB2 
DFSMS 
ESA/370 
MVS/DFP 
MVS/ESA 
MVS/SP 
MVS/XA 
System/370 
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Preface 


This manual describes the commands to use Data Facility Data Set Services 
(DFDSS) and is intended for the storage administrator and the system programmer. 
Its purpose is to explain the command syntax to perform various storage manage- 
ment tasks. 


Major Divisions of This Book 
This book is organized as follows: 


Chapter 1, Specifying DFDSS Commands describes syntax requirements and 
their conventions and summarizes the JCL you might need to use DFDSS. 


Chapter 2, Choosing the Data Sets You Want Processed—Filtering describes the 
filtering process, filtering by data set name or by data set characteristics, and the 
standard catalog search order. 


Chapter 3, Syntax—Function Commands describes the DFDSS commands, their 
keywords, and examples of how they are used. 


Chapter 4, Syntax—Auxiliary Commands describes the commands that allow you 
to control DFDSS processing in the SYSIN data set. 


Chapter 5, Stand-alone DFDSS Restore Program describes how to use the stand- 
alone DFDSS restore program and provides examples of job streams to process 
stand-alone DFDSS restore. 


Chapter 6, Customizing DFDSS and Its Interfaces explains how you can cus- 
tomize DFDSS by coding exit routines and tailoring Interactive Storage Man- 
agement Facility (SMF) panels. 


Appendix A, Compatibility Considerations for Prior Releases provides informa- 
tion regarding compatibility of prior releases with DFDSS Version 2 Release 5. 


Appendix B, Serialization and Authorization Checking discusses how serialization 
is accomplished, the purpose of serialization, and how DFDSS checks user 
authorization. 


Appendix C, User Interaction Module Exit Options discusses the various parts of 
the Application Interface. 


Appendix D, Examples of the Application Program with the User Interaction 
Module (UIM) provides examples and explanations of the UIM exit functions. 


Appendix E, Data Area Descriptions describes two data area descriptions. 


Appendix F, Macro Library as Part of Programming Interfaces for Customers 
identifies product-sensitive and general-use programming interfaces. 


Required Product Knowledge 


To use this manual you need some knowledge of Data Facility Product (DFP), Data 
Facility Hierarchical Storage Manager (DFHSM), Resource Access Control Facility 
(RACF), and job control language (JCL). 


Special Notices _ ii 
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DFDSS Machine Requirements 


DFDSS Version 2 Release 5 is designed to operate on any IBM processor that is 
supported by MVS/System Product Version 1, Version 2, or Version 3. 


DFDSS Books 


Data Facility Data Set Services: General Information, GC26-4123, introduces you 
to DFDSS and helps in evaluating its use. 


Data Facility Data Set Services: User’s Guide, SC26-4388, gives guidance on how 
to use DFDSS. 


Data Facility Data Set Services: Messages, SC26-4390, lists DFDSS messages. 


Data Facility Data Set Services: Diagnosis Guide, LY27-9538, tells how to diag- 
nose errors you may encounter while using DFDSS. . 


Data Facility Data Set Services/Interactive Storage Management Facility: Instal- 
lation Planning Guide, SC26-4129, tells what to consider when planning for and 
installing DFDSS/ISMF. 


Referenced Books 


Within the text, the following books are referenced: 


iv DFDSS: Reference 


MVS/ESA Application Development Guide, GC28-1821 
MVS/DFP Version 3 Release 2: Customization, SC26-4560 
MVS/DFP Version 3 Release 2: Utilities, SC26-4559 


MVS/DFP Version 3 Release 2: Access Method Services for the Integrated 
Catalog Facility, SC26-4562 


MVS/DFP Version 3 Release 2: Managing VSAM Data Sets, SC26-4568 
MVS/ESA JCL User’s Guide, GC28-1830 
MVS/ESA JCL Reference, GC28-1829 


Resource Access Control Facility (RACF) General Information Manual, 
GC28-0722 


Resource Access Control Facility (RACF) Security Administrator’s Guide, 
SC28-1340. 
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Summary of Changes 


xii 


Version 2 Release 5, December 1989 


DFDSS Version 2 Release 5 provides additional storage management facilities and 
enhancements to help you: 


Take advantage of a new type of data set. 


MVS/DFP Version 3 Release 2 now provides a specially designed data set, called 
a partitioned data set extended (PDSE). DFDSS supports the PDSE, which 
offers significant advantages over a partitioned data set (PDS). DFDSS also 
provides new keywords to convert a PDS to a PDSE and a PDSE to a PDS. 


This support requires MVS/DFP Version 3 Release 2 or a later release. 
Use new application interface exit points. 


New options for application interface exits further enhance the interaction 
between DFDSS and its invoking program at the data set level. DFDSS passes 
control to the user interaction module (UIM) when a data set is selected and 
when the processing of that data set is completed. At these exit points, the UIM_ 
can perform a number of tasks. For example, you can customize the UIM to 
end processing of the data set or to bypass options such as serialization and 
security verification. 


Process ne = with a high-level qualifier of SYS1. By using the 
PROCESS(SYS!) keyword. you can: 


1 


= nece LS d space in partitioned or sequenia. data sets with a high-level 


viove daia sets with a high-level qualifier of SYSi. 


— Specity the DELETE keyword with the DUMP command to dump and 
delete data sets with a high-level qualifier of SYSI. 


— Replace preallocated data sets that have a high-level qualifier of SYSI. 


Process data sets that have undefined DSORG. By using the 
PROCESS(UNDEFINEDSORG) keyword, vou can copy or restore undefined 
DSORG data sets to an unlike device that has a larger track capacity. 


Specify both the OPTIMIZE and COMPRESS kes words for dumps. 


You no icnger must choose between performance (by specifying OPTIMIZE) vu: 
saving space (by specifving COMPRESS). You can back up data by using bois 
xeywords, 


Reduce CPU time by improving the data compression algorithm during DUM?. 
Use stand-alone RESTORE to restore compressed dump data. 


Reduce I O to the VVDS during logical data set DUMP/RESTORE. data set 
COPY and CONVERTV. 


Declare a larger block size fora SYSPRINT data set or the output data set from 
the PRINT command. 


DFDSS now allows a block size greater than 141. 
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Command Syntax 


Chapter 1. Specifying DFDSS Commands 


This chapter is divided into the following sections: 


Command Syntax 


“Command Syntax” describes syntax requirements. 


“How Many Subkeywords Are Allowed?” on page 2 lists possible combinations __. 


of subkeywords that you can specify in the input (command) stream. 


“Specifying Subkeywords in a Command Data Set” on page 3 explains how to 
use keywords in a command data set. 


“How to Read Syntax Diagrams” on page 3 explains the syntax conventions 
used in this book. 


“The JCL You Need” on page 5 summarizes the job control language (JCL) 
that you might need to use DFDSS. 


You can write DFDSS commands in free form in card columns 2 through 72 (inclu- 
sive). Anv character in column | and past column 72 is ignored thus causing unpre- 
_dictable results when the task is processed. Syntax requirements are: 


¢ A command must appear first, followed by its keywords. 


A command is separated from its keywords by one or more blanks, a comment, 
or both. For example: 


DUMP FULL INDD(DASD1) OUTDD(TAPE1) 


A comment is a string of characters preceded by /* and followed by */. A 
comment must be started and finished on the same line. For example: 


/* THIS IS A COMMENT */ 
A separator consists of a comma (,), or one or more blanks, or a comment. 
Keywords are separated from one another by one or more separators. 


Subkevwords are separated from one another by one or more separators. 
Subkeywords follow their associated keywords and are separated from them by a 
pair of enclosing parentheses. One or more blanks can, optionally, precede and 
follow each parenthesis in the pair. For example: 


REBLOCK( DATASET1 ) 
Or 
REBLOCK(DATASET1) 


If two or more subkeywords are permissible for a single keyword, these are sepa- 
rated from one another by at least one blank. Subkeywords can also be sepa- 
rated from one another by commas, where each comma can, optionally, be 
preceded and followed by one or more blanks. For example: 


REBLOCK{DATASET1 , DATASET2) 
or 

REBLOCK(DATASET1, DATASET2) 
or 


REBLOCK(DATASET1 DATASET2) 
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¢ Continuation of a command is specified by a hyphen (-) as the right-most non- 
blank character, preceded by one or more blanks. For example: 


COPY DATASET (INCLUDE(DATASET1)) ALLDATA(*) - 
CATALOG REBLOCK(DATASET1) 


The absence of such a hyphen indicates the end of the command. If a keyword 
or subkeyword cannot fit on the remainder of a line, it can be started on that 


Sgekshy Sepa oe kia PL ERTS EP TRO pay Tabac itens Sok wigan ela 2 Tae ak te Siac weg 


line, followed immediately by a plus sign (+.) in column 72,:and continued on =: °: 


the next line. 


¢ The end of a command can also be specified by a semicolon. Everything to the 
right of the semicolon is ignored. 


How Many Subkeywords Are Allowed? 


The following is not a comprehensive list of keywords with subkeywords, but rather 
a list of keywords that can have a maximum of 255 subkeywords specified in the 
inline command stream. 


ALLDATA(subkeyword) 
BY(subkeyword) . 
BY(LIST(subkeyword)) 
BYPASSACS(subkeyword) 

~ - CONVERT(PDS(subkeyword)) 
CONVERT(PDSE(subkeyword)) 
DDNAME(subkeyword) 
DYNAM (subkeyword) 
EXCLUDE(subkeyword) 
EXCLU DE(LIST(subkeyword)) 
INCATisubkeyword) 
INCLU DE(subkeyword) 
INDDNAME(subkeyword) 
INDYNAM (subkeyword) 
LOGIC ALVOLUME(subkeyword) 
LOGIN DDNAME(subkeyword) 
LOGINDYNAM(subkeyword) 
NOPACKING(dsn) 
OUTDDNAME(subkeyword) 
OUTDY NAM(subkeyword) 
OUTTRACKS(subkeyword) 
PASSW ORD(subkeyword) 
PERCENTUTILIZED(subkeyword) 
REBLOCK(subkeyword) 
REBLOCKADDRESS(subkeyword) 
RENAME(subkeyword) 
RENAMEUNCONDITIONAL(subkeyword) 
TRACKOVERFLOW(subkeyword) 
TRACK S(subkeyword) 
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Syntax Conventions °° 


Specifying Subkeywords in a Command Data Set 


As an alternative to specifying the data set names in the inline (Command) stream, 
you can specify the ddname of a sequential or data set member of a partitioned data 
set that contains the list of data set names. This allows you to specify more than 
255 data set names. The keywords that allow this ddname specification are: 


DATASET(FILTERDD(ddn)) 
EXCLUDE(DDNAME(ddn)) 
FILTERDD(ddn) 
PASSWORD(ddn) 


How to Read Syntax Diagrams 


There is one basic rule for reading the syntax diagrams: Follow only one line ata 
time from the beginning to the end, and code everything you encounter on that line. 


The following rules apply to the conventions used in the syntax diagrams for all the 
DF DSS commands: 


Read the syntax diagrams from left to right and FrotH op to bottont. 


Each syntax diagram begins with a double arrowhead ae: and ends with 


- Opposing arrows (>). 


An arrow () at the end of a line indicates that the syntax continues on the next 
line. A continuation line begins with an arrow (—). 


Commands and keywords can contain uppercase and lowercase letters. The 
uppercase portion is the minimum needed to code the command properly; the 
lowercase portion is optional. For example, COPYDump can be coded in any of the 
following ways: COPYD, COPYDU, COPYDUM, or COPYDUMP. 


Note: All commands must be entered in uppercase. Lowercase is not recog- 
nized. 


Some commands and keywords have alternative abbreviations; these appear as 
part of the stack for that command or keyword. For example, the alternative 
abbreviation for COPYDump is CPYD. 


CPYD 


Words in all lowercase letters represent information you supply. For example, 
volser or ddn. 


You must provide all items enclosed in parentheses, (). You must include the 
parentheses. 


Where you can choose from two or more keywords, the choices are stacked one 
above the other. If one choice within the stack lies on the main path, the 
keyword is required, and you must choose one or none. In the following 
example you must choose either BLK, TRK, or SOURCE. 


BLK 
L-tex— 
SOURCE 
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e Ifa stack is placed below the main path, the keyword is optional, and you can - 


choose one or none. In the following example CATalog and RECATalog are 
optional keywords. You can choose either one or the other, but not both. 


Le ATal aa 


—RECATalog— 


-¢ The repeat symbol 4 shows that you can specify a keyword (or keywords) 
and variables more than once. The repeat symbol appears above the keywords 
and variables that can be repeated. When a comma appears in the repeat 
symbol, you must separate repeated keywords with a comma. 


The following example illustrates all the rules described above. The numbers in the 
diagram are keyed to the explanations that follow. 


COPYDump Command 





cOPYDump]—-10Dn (46n)=auTonnaney-( ee ra] 
.}——_—_- 


CPY 1D 
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Figure |. Example of a Syntax Diagram for the COPYDump Command 


Either the command COPYD (or any other acceptable abbreviation of COPYDump) or 
the alternate abbreviation CPYD must be specified. 


Either the keyword INDD (or any acceptable abbreviation of INDDname) or the 
alternate abbreviation IDD must be specified, followed by one ddm. You must 
provide the ddn enclosed in parenthesis. 


Either the keyword OUTDD (or any acceptable abbreviation of oUTDDname) or the 
alternate abbreviation 0DD must be specified, followed by up to 255 ddns. Each list 
of ddns must be enclosed in parentheses and each ddn must be separated by a 
comma. 


EE] When there is a single arrow head at the end of a line, the syntax continues on 
the next line. 


5 | The LOG and LVOL keywords are optional, because they fall below the mainpath. 
You can specify as many volume serial numbers (volser) as needed on either keyword 
with each ro/ser separated by a comma and enclosed in parentheses. 


a The substitution block A is used to simplify the syntax diagram. It indicates 
that a block of the syntax diagram is located outside of the main diagram. You 
insert the keywords for that block where the symbol appears. You then return to 





oo JCL 


the main diagram to continue with the command. For example, with the RESTORE 
command there are optional keywords for both FULL and TRACKS 


>>—-RESTor FULL 
ru— ri 


. Optional Keywords used with FULL 


—CANcel oe Lcoprver ie 
CPYV. 


The following example shows how the COPYDump command might be used (the JCL is 
included): 


//JQB2 JOB accounting information, REGION=nnnnk 
//STEPL EXEC PGM=ADRDSSU 

//SYSPRINT DD SYSOUT=A 

/{TAPE2 DD UNIT=3480,VOL=SER=TAPE20, 


dd LABEL=(1,SL) ,DISP=(OLD,CATALOG) ,DSN=USER.BACKUP.REL3A 
//OUTT2 DD UNIT=3480,VOL=SER=TAPE21, 
Le LABEL=(1,SL) ,DISP=(NEW, CATALOG) ,DSN=USER.BACKUP.REL3A.A 
//SYSIN DD 6h* - 3 
COPYDUMP - 
INDD(TAPE2) /* DUMP TAPE TO BE COPIED */ - 
OUTDD(OUTT2) /* NEW DUMP TAPE */ - 
LVOL (338001) a /* SER NO OF VOL TO BE COPIED */ 
[> 


The JCL You Need 


The examples in this manual are shown with the necessary JCL. You may need the 
following JCL to use DFDSS: 


Statement Usage 
JOB (required) Initiates your job. 
EXEC (required) Specifies the program name (PGM=ADRDSSVU) or, if 


the job control statements reside in a procedure library, 
the procedure name. See “How to Control DFDSS via 
PARM Information in the EXEC Statement” on page 6 
for additional information that can be entered in the 
PARM parameter of the EXEC statement. 


SYSPRINT DD (required) Defines a sequential message data set. The data set can 
be written to a system output device, a tape volume, or a 
direct-access device. If the DCB keyword LRECL is 
specified on the DD statement, it must be in the ranges 
of 84 to 137 inclusive. If BLKSIZE is specified, it must 
be at least four greater than the LRECL. If an LRECL 
less than 84 is chosen, the return code is 8 and an error 
message is issued. If the specified LRECL is greater 
than 137, then LRECL and BLKSIZE are set to 137 and 
141, respectively. 


SYSIN DD (required) Defines a command data set consisting of cards or card- 
image records that contains your DFDSS commands. It 
usually resides in the input stream, however, it can be 
defined as a blocked or unblocked sequential data set or 
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asa wigber of a Se ones data set. Records must be 
fixed format, LRECL = 80. 


input DD (optional) Defines the input (also called the source). The ddname, 
input, is supplied by you and is referred to by your 
DFDSS commands. This DD statement is not required 
for some operations. Do not specify BUFNO. 


_ output DD (optional) . Defines the output (also called the target). The ddname, 


output, is supplied by you and is referred to by your 
DFDSS commands. This DD statement is not required 
for some DFDSS operations. Do not specify BUFNO. 
Code a volume count when a new data set will reside on 
six or more volumes. (Note that DISP= MOD is not 
supported for an output DD statement.) 


filter DD (optional) Defines a data set consisting of cards or card-image 
records that contains the filtering criteria (INCLUDE, 
EXCLUDE, and BY) to be used in a data set command. 
The ddname, filter, is supplied by you and is referred to 
by your DF DSS commands. 


Note: Vou cannot concatenate ‘DD: statements to aie 
filter DD statement. 


password DD (optional) _ Defines a data set consisting of card-image records that © 
contains data set names and their passwords. The 
ddname, password, is supplied by you and is referred to 
by your DFDSS commands. 


For more information on coding JCL, see UVS/ESA JCL Reference. 


How to Control DFDSS via PARM Information in the EXEC Statement 
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The EXEC statement for DFDSS can contain PARM information that is used by 
the program. You can use the following keyword parameters: 


TYPRUN =SCAN 
Only control card syntax checking is done. No tasks are processed. 


TYPRUN = NORUN 
For COPY, DUMP, RESTORE, COMPRESS, CONVERTYV, and RELEASE 
operations, only data set filtering is to be done without actually processing data 
sets. Printed output for the run indicates the data sets selected. Fora 
DEFRAG operation, the initial volume statistics are to be printed without actu- 
ally relocating any extents. Fora CONVERTV operation, a full report is 
produced, but no volumes or data sets are actually converted. 


PAGENO = onan 
The nnnn is a |- to 4-digit number indicating the starting page number to be 
used for the SYSPRINT data set. The default is 1. 


LINECNT = nnnn 
The nnnn is a |- to 4-digit number indicating the number of lines to be printed 
per page for the SYSPRINT data set. The default is 60. Specify 
LINECNT = 9999 to prevent a page ejection. 


SIZE =nonnok 
The nnnn is a |- to 4-digit number indicating the number of K bytes (1K equals 
1024 bytes) of main storage to be used by DFDSS. This amount must be less 
than or equal to that specified by the REGION keyword. The default value is 
the region size. 


A eral alunite Sh Geeky ceescene: 
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ABEND = nnn 


The nnn is a 3-digit decimal message number (ADRnnnx). If this is specified, 
and this message is to be issued, DFDSS performs a user 0001 ABEND dump 
after issuing the message, and the task stops. To get a dump, include a DD 
statement for SYSABEND or SYSUDUMP. This keyword is provided for 
debugging purposes only. 


AMSGCNT = nnon | 
The abend message occurrence count that tells DFDSS to end abnormally on * 
the nth occurrence of the message specified in ABEND=nnn. The nnnn for 
AMSGCNT can be a number between | and 9999. The default is | (first occur- 
rence). 


RACFLOG = YES 
Resource Access Control Facility (RACF) logging is done for all function tasks. 
This parameter can be overridden or set by the user installation options exit. 
See “RACF Logging during Authorization Checking” on page 177 fora 
description of DFDSS RACF logging. 


TRACE = YES 
When used during a DEFRAG operation, this results in printing messages that 
indicate the relocated extents. This is a debugging tool. 


UTILMSG = YES 
Messages from auxiliary programs, such as IEBCOPY and ICKDSF, are copied 
into the DFDSS SYSPRINT output. 


XABUFF = ABOVE16|BELOW16 
The I O buffers used by DFDSS for COPY, COPYDUMP, DEFRAG, DUMP. 
PRINT, and RESTORE operations are to be above or below 16 megabytes 
virtual storage. The default, when DFDSS runs under MVS/XA, is ABOVE]I6. 
This parameter is ignored when DF DSS runs under MVS/370. 


WORKUNIT = workunit 
You can supply an esoteric DASD unit name (for example, SYSDA), generic 
DASD unit name (for example, 3380). or a specific DASD address. DFDSS 
passes this unit to dynamic allocation when temporary data sets are allocated. 


WORKV OL = volser 
You can supply a volser on which DFDSS should allocate temporary data set 
DFDSS passes the volser to dynamic allocation. 


Notes: 


1. WORKUNIT, WORKVOL, or both parameters can be specified when 
invoking DFDSS. 


2. When DFDSS invokes the IDCAMS utility to copy an ICF user catalog, the 
export data set is allocated as a permanent data set. The permanent data set 
cannot be placed on the volume specified by WORKUNIT and/or 
WORKVOL. 


3. An esoteric unit name that requests virtual I/O can be used in the 
WORKUNIT parameter, but when DFDSS invokes the IEHMOVE utility 
during data set copy, the default dynamic allocation unit name is used 
(SYSALLDA). 
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Examples of PARM information are: 


// EXEC PGM=ADRDSSU, 
// PARM= ' PAGENO=8, LINECNT=57 , SIZE=500K,UTILMSG=YES ' 


// EXEC PGM=ADRDSSU, PARM='TYPRUN=SCAN, XABUFF=ABOVE16' 


~" For further information on the PARM parameter of an EXEC statement, see 
MVS/ESA Application Development Guide. 
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Chapter 2. Choosing the Data Sets You Want 
Processed—Filtering 


This chapter is divided into the following sections: 


¢ “How DFDSS Filters Data Sets” describes how DFDSS filters data ‘sets by data -. - 
set name and by data set characteristic. 


¢ “Filtering by Data Set Names” on page 10 explains how to specify fully- and 
partially-qualified data set names for filtering. This section includes rules for 
spelling out qualifiers and examples of qualified data set names. 


e “Filtering by Data Set Characteristics” on page 12 lists the data set character- 
istics on which filtering can be done. 


e “Standard Catalog Search Order” on page 16 identifies the standard order in 
which DFDSS searches for a data set name. 


‘How DFDSS Filters Data Sets | 
DFDSS filters data sets by: 


1. Applying inclusion and/or exclusion criteria to fully- or partially-qualified data 
set names. 


a. If you specify inclusion (INCLUDE) criteria, DFDSS tentatively selects all 
data sets that fit any of the criteria. 


Note: If inclusion (INCLUDE) criteria are not specified, then EXCLUDE 
or BY must be. In this case, DFDSS tentatively selects all data sets (equiv- 
alent to INCLUDE(**)). For the DEFRAG command, INCLUDE/**) is 
always implied. 


b. If vou specify exclusion (EXCLUDE) criteria, DFDSS surveys the data sets 
selected in Step la and rejects the data sets that fit any of the criteria. 


2. Applying data set characteristics (BY) criteria to the data sets tentatively selected 
in Step |. DFDSS selects only those data sets that satisfy all BY criteria. 


DFDSS lets you find out which data sets are selected by the filtering process without 
actually performing the requested operation(s). You can do this by specifying the 
TYPRUN =NORUN option on the JCL EXEC PARM field. 


Considerations for VSAM Data Sets: 
* INCLUDE and/or EXCLUDE filtering is performed on the cluster names of the 
data sets. 


¢ Ifthe BY criterion DSORG, MULTI, CATLG, or FSIZE is specified, filtering is 
done at the cluster level. If you specify other BY criteria, the data components 
of the selected clusters are further filtered on those BY criteria by using informa- 
tion from the VTOC. Ifa data component is selected, the index component for 
the cluster is also selected. 


¢ DFDSS supports the BY criterion EXPDT as it exists in the VTOC only. For 
releases prior to DFP Version 3 Release |, when a VSAM data set is defined by 
IDCAMS, the expiration date is in the catalog instead of the VTOC. Hence, the 
EXPDT is not used by DFDSS. 
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e A fully- qualified name is required in order to dump a VSAM data set that is in - 
open-for-update status. 


e For physical data set RESTORE: To prevent index components from being 
restored inadvertently, you must specify the fully-qualified name of the cluster. 


¢ For data set PRINT: The fully-qualified name of the data set to be printed is 
required. Support is at the component, not the cluster, level. 


Filtering by Data Set Names 


A fully-qualified data set name is one in which all qualifiers are completely spelled 
out. A partially-qualified data set name is one in which asterisks (*) and percent 
signs (%) are used to represent qualifiers or parts of qualifiers. 


Using an * in Partially-Qualified Data Set Names 
The single asterisk, *, is used in place of exactly one qualifier. In addition, it can be 
used to indicate to DFDSS that only part of a qualifier has been ce for 
example, just the first, last, middle, or first and. last parts. 


When used with other qualifiers, the double asterisk, **, indicates either the nonexist- 
ence of leading, trailing, or middle qualifiers, or the fact that ey pas no eae in ane 
_ Selection process. 
The following rules regarding asterisks in a qualifier must be observed: 
¢ Two asterisks are the maximum permissible in a qualifier. 
¢ If there are two asterisks in a qualifier, then the asterisks must be the first and 


last characters. 


Consequently, the following are permissible qualifiers: 
kk 


*A* 


The following are not permissible qualifiers: 
weAX 
*A*B* 
*A*B 
A*B*C 


Using a % in Partially-Qualified Data Set Names 
The % acts as a place holder for a single character during data set name filtering. 
The rules for using % are: 


¢ Each % corresponds to exactly one character. 
* % can be specified more than once, consecutively or in any level of the qualifier. 
e A % cannot match a null (''), blank (' '), or period ('.'). 


¢ Use of a % in filtering does not change any of the other filtering specifications 
for data set names. 
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Consequently, specifying 
1%M.A.%AT%%ET 

will match the data set names 
ITAM.A.DATASET 
IBM.A.BATTYET 

but not 


IAM.A.DATASE 
IAM.AA.DATASET 
TAM.A.ATASET 
IM.A.DATASET 


Examples of Fully- and Partially-Qualified Data Set Names 
Examples of fully-qualified data set names: 


USER2LD The first and only qualifier is CGSER2LD. 
SYS1.UTIL3.LOAD The first qualifier is SYS/, the second, UTIL3, and the third, 
LOAD. 


USER2.PROGRAM1.LIST The first qualifier is USER?, the second, PROGRAM1, and 
the third, LIST. 


Examples of partially-qualified data set names using **: 


** LOAD All data sets whose last, or only, qualifier is LOAD. 
SYSi.** All data sets whose first, or only, qualifier is SYS/. 
USERZ. **. LISI All data sets whose first and last qualifiers are USER2 and 


LIST, respectively, including USER2.LIST. 


Additional examples of partially-qualified data set names: 


* ,LOAD All data sets with two qualifiers whose last qualifier is LOAD. 

SYSi2* All data sets with two qualifiers whose first qualifier is SYS/. 

SYS1.*. LOAD All data sets with three qualifiers whose first and last qual- 
ifiers are SYS] and LOAD, respectively. 

SYSL.UL*y LIST. All data sets with three qualifiers whose first and last qual- 


ifiers are SYS] and LIST, respectively, and whose second 
qualifier begins with UT. 


iss All data sets whose last, or only, qualifier ends with LJB. 

**  *LIB* All data sets whose last. or only, qualifier has L/B in it. 

PPL All data sets with three qualifiers whose second qualifier has 
PLI in it. 

* * PPM All data sets with three qualifiers whose last qualifier begins 


with P and ends with ©. 
ee All data sets. 


%.LIST All data sets with one character in the first qualifier 
and LIST in the last qualifier. 
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USER%.* All ines, sets with two qualifiers whose first qualifier i is USER 
followed by some other character. 

* 45% All data sets whose single qualifier consists of two or more 
characters. 


Note: Single quotation marks around either a fully- or partially-qualified data set 
name indicates the name is fully-qualified. Do not use single quotation marks to 


- enclose a data set name that will appear in a DFDSS control statement. ° 


Relative Generation Filtering 


DFDSS allows filtering on relative generations of a generation data group (GDG) 
data set in the INCLUDE, EXCLUDE, and REBLOCK data set name lists. A 
GDG is specified as dsn(n) where dsn is a fully- or partially-qualified base name 
without the last qualifier (GggggVvv), and nv is the relative generation number or * 
for all generations. 


Examples of relative generation filtering are: 

dsn(0) For the current generation 

dsn(—x) For the xth prior generation 

dsn(+x) For the xth future generation 

dsn(*) - —- For all generations. 

For logical operations, you must use either the fully-qualified data set name, the 
partially-qualified base name with the last qualifier (GggggVvv), or the above rela- 


tive generation filtering. Partial qualification of the last qualifier (GggggVvv) is not 
supported. 


Filtering by Data Set Characteristics 
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After DFDSS has tentatively selected data sets by applying INCLUDE and 
EXCLUDE criteria, you can apply BY criteria to further restrict the data sets finally 
chosen. You can. for example. use BY to select data sets by creation date, storage 
class, and a wide variety of other criteria. The BY keyword takes this form: 






——— 


>>———B Y—_——( Sane ee ence ace )—-_ 
Where Represents 
schar The selection characteristics: 
Keyword Criteria 
ALLOC Allocation type (cvlinder, track, block, absolute track, 


or movable). 


CATLG Whether the data set is currently cataloged or not 
(using the standard catalog search order). 


CREDT Creation date (absolute or relative). 
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DSCHA Whether the data-set-changed flag is on or off. 
| DSORG Data set organization (SAM, PAM, PDS, PDSE, 
| BDAM, EXCP, ISAM, or VSAM). 
| EXPDT Expiration date (absolute or relative)! 
EXTNT Number of allocated or used extents for the entire data 
_ _ set on all the volumes on which it resides. . 2h 
FSIZE Number of allocated or used tracks for the entire data 
set on all the volumes on which it resides (data set 
size). 
MULTI Whether the data set is single- or multivolume. 
REFDT Last-referenced date (absolute or relative). 


DATACLAS Data class for SMS 
MGMTCLAS Management class for SMS 
STORCLAS Storage class for SMS 


op The operator: 
Operator Meaning 
EQ or = Equal to 
LE or <= Less than or equal to 
LT or < Less than 
GT or > Greater than 
GE or >= Greater than or equal to 
NE or == Not equal to. 
arg An argument that qualifies the selection characteristic (schar) 


Figure 2 on page 14 summarizes the permissible combinations of schar, op, and arg. 


| |! Data sets without expiration dates explicitly assigned to them are considered to have an expiration date of zero. If 
| you wish to exclude these data sets from expiration date processing, you must specifically exclude them in your 
filtering list, that is, BY EXPDT NE 00000. 


2 To filter on the last-referenced date for VSAM data sets, if Data Facility Hierarchical Storage Manager (DFHSM) 
| is not installed, module IDATMSTP (in load module I[IDA0192A) must be modified to send a return code of 4 to its 
| caller. 
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Figure 2 (Page 1 of 2). BY Keywords 
schar op arg Notes 
ALLOC EQ CYL (cylinder allocation) If MOV is picked, the data sets to be proc- 
NE TRK (track allocation) essed cannot be allocated as any of the fol- 
BLK (block length allocation) lowing: 


ABSTR (absolute track allocation) 


MOV (movable data sets) _ ¢ PSU (physical sequential unmovable) 


..,© POU (partitioned organization unmov-.-. . 
able) 
¢ DAU (BDAM unmovable) 
¢ ABSTR (absolute tracks) 
¢ ISAM (indexed sequential access 
method). 


For the COMPRESS command, if MOV is 
picked, only data sets allocated as POU 
cannot be compressed. 


CATLG EQ YES (or 1) If YES is specified, only data sets that are 
NO (or 0) currently cataloged are processed. If NO is 
specified, only uncataloged data sets are 
processed. 


Note: A data set is considered not cata- 
loged if it is not cataloged in the standard . 
order of search or if the catalog that the 
data set is cataloged in is not available. 

For the DUMP command. specifying YES is 
valid only fora physicaldump. ..s—s—sC«sy 
For the COPY command, specifying yes is 
valid only for a COPY with INDD or 
LOGINDD. 

For the RESTORE command, the target 
data set is tested to determine if it is cata- 
loged or not. 


CREDT LT yvddd[,n]: Year and day, modified by a I- to 4-digit If you specify a vy of 00 through 50. 
EXPDT GT positive or negative number, n. For example, 86100 DFDSS assumes you want years 2000 
REFDT EQ means the 100th day of 1986. through 2050: if you specify a yy of 51 

NE *(.n]: Run date, modified by the 1- to 4-digit positive through 99, DFDSS assumes 1951 through 

GE or negative number, n. For example, *,-S5 means five 1999. 

LE davs before this job is run. CREDT and EXPDT: For a multivolume 


data set, the date from its first volume’s 
VTOC is used for checking. 

REFDT: For a multivolume data set, the 
latest date from all its VTOCs is used for 
checking. 

For the RELEASE and DEFRAG com- 
mands, the date in the VTOC of the volume 
being processed is used for filtering both 
single- and multivolume data sets. 


DSCHA EQ YES (or 1) For a multivolume data set, the value used 
NE NO (or 0) for checking is | if any of the indicators 
from all of its VTOCs is 1. Otherwise, the 
value used is 0. 


DSORG EQ SAM EXCP applies to data sets not allocated as 
NE PAM any of the listed organizations and not 

PDS accessed by using any of the listed access 
PDSE methods. 
BDAM For the COMPRESS command, because 
ISAM DFDSS assumes data set organization, you 
VSAM do not need to specify it. 
EXCP 
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Figure 2 (Page 2 of 2) 


schar op 
EXTNT LT 
FSIZE GT 
EQ 
NE 
GE 
LE 
MULTI EQ 
DATACLAS EQ 
MGMTCLAS NE 
STORCLAS 


Filtering by Data Set Characteristics *— 


. BY Keywords 


arg 


nonnn: where nnnnn is a 1- to 5-digit number (in the 
range 0 to 99999) 


YES (or 1) 
NO (or 0) 


An appropriate SMS class name. 


Notes to Figure 2: 


‘data set determines the number of used or ‘” 
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Notes 


This is the number of used or allocated 
extents (EXTNT) or used or allocated 
tracks (FSIZE) for an entire data set on all 
the volume(s) on which it resides. 

For the RESTORE command, the dump 


allocated extents or tracks. 

For the DUMP and COPY commands, if 
ALLDATA or ALLEXCP is specified, 
FSIZE is equal to the allocated tracks and 
EXTNT is equal to the allocated extents. 


If YES is specified, DFDSS processes only 
multivolume data sets. If NO is specified, 
DFDSS processes only single-volume data 
sets. 

For the DEFRAG command. if a data set’s 
volume sequence number is greater than 
one in the VTOC, DFDSS assumes it is 
multivolume. If this sequence number is 1, 
DFDSS assumes it is a single-volume data 
set. 

For the COMPRESS command, because 
DFDSS assumes the data set is single- 
volume, you do not need to specify 
MULTI. , 


When multiple arguments are specified for an NE operation, DFDSS selects 
only those data sets not matching anv of the arguments. 


When multiple arguments are specified for an EQ operation, DFDSS selects 
those data sets matching any of the arguments. 


BY criteria do not apply for the CONVERTYV or COPYDUMP commands. 


Some Examples of the BY Keywords 
If you code 


BY(({ALLOC EQ CYL) (CATLG EQ YES)) 


you will receive all cataloged data sets with cylinder allocation. 


If you code 
BY(FSIZE GE 100) 


you will receive all data sets whose size is greater than or equal to 100 tracks. 


If you code 
BY(DSORG EQ (PAM, SAM) ) 


DFDSS will select all PAM and SAM data sets. 
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For a complete description of the standard catalog search order, see the appropriate 
MVS/DFP Version 3 Release 2: Access Method Services for the Integrated Catalog 
Facility. 


..When catalogs are searched for a data set name, the standard order. of the search is: . 


1. For DFP Version 3 Release 1, or subsequent releases, DFDSS first searches the 
catalogs specified with INCAT, if any. 


2. DFDSS searches the user catalog(s) specified in the current job step 
(STEPCAT), or if none is specified for the job step, the user catalog(s) specified 
for the current job JOBCAT). If more than one catalog is specified for the job 
step or job, the catalogs are searched in order of concatenation. 


Note: If data sets with the same name are cataloged in more than one catalog 
within the standard search order, DFDSS selects only the first one encountered. 
Aiso, STEPCAT and JOBCAT can be used only in a non-SMS environment. 


3. If the data set name is a qualified name and is the name of a user catalog, or the 
_ data set name is the same as the alias of a user catalog or the alias of a CVOL, 
DFDSS searches that user catalog or CVOL. 


4. DFDSS searches the master catalog. 
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Chapter 3. Syntax—Function Commands 


This chapter describes function commands. Function commands specify tasks, which 
are Operations to be performed. The commands are 


COMPRESS 
CONVERTV 
COPY 
COPYDUMP 
DEFRAG 
DUMP 
PRINT 
RELEASE 
RESTORE. 


The Dara Facility Data Set Services: User’s Guide contains usage notes, including 
DFDSS restrictions. Refer to these notes as needed. 


This chapter begins with a task-oriented overview of each command, followed by 
detailed descriptions in alphabetical order. Each description contains: 


An overview of the function command 

Syntax for the command 

Explanation of keywords and subkeywords for the cooumand 
Data integrity considerations and format of the output data set 
Examples of command operations using keywords. 


Product implementation information is contained in this chapter. 


What DFDSS Commands Can Do 


Backup and Recovery 


Data Movement 


& Copyright IBM Corp. 1984, 


With DFDSS, you can back up vour data in case of hardware failure or user error. 
You can use DFDSS to back up data on DASD and to restore the backup if the 
origina: is lost, damaged, or changed inadvertentiv. In addition to providing for 
routine ee requirements, DFDSS can be used to back up application data for 
disaster recovery and vital records purposes. 


You can use DFDSS to back up and recover datz sets, entire volumes, or specific 
tracks. The DF DSS DUMP command Is used to pack up tracks, volumes, and data 
sets. The RESTORE command is used to recover them. 


Moving data is an essential part of storage management. In order to replace storage 
devices. add storage capacity, and meet storage requirements, you must move data. 
The data movement support that DFDSS provides allows you to: 


* Mfove data sets from old to new direct-access storage devices (DASD) 
¢ Move data sets between SMS- and non-SMS-managed volumes 

¢ Move data sets off a volume when hardware maintenance is required 
* Move or copy data sets for other purposes. 
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You can move data sets from one DASD volume to another volume of like or unlike 
device type}. Or, you can copy a full volume or ranges of tracks, in which case the 
DASD must be of like device type. 


The DFDSS COPY command is used to perform data set, volume, and track move- 
ment. 


Conversion to and from Storage Management Subsystem (SMS) 
SMS allows you to match the needs of users’ data (like data set organization, size, 
and format) to the characteristics of storage devices without requiring users to know 
or understand your installation’s hardware configuration. With SMS, users can 
store and retrieve data without being aware of space limitations, device character- 
istics. or volume serial numbers. 


The DFDSS CONVERTY command is used to convert existing volumes to and 
from SMS management without data movement. 


Space Management 
With DFDSS, you can effectively manage space. DFDSS provides features to con- 
solidate free space on volumes, compress partitioned data sets, and release unused 
space in data sets. 


The DFDSS DEFRAG command is used to consolidate the free space on a volume 
to help prevent out of space abends on new allocations. The DFDSS COMPRESS 
command is used to compress partitioned data sets by taking unused space and con- 
solidating it at the end of the data set. The DFDSS RELEASE command is used to 
release unused space in sequential and partitioned data sets for use by other data 


Sets. 


Conversion from a PDSioa eee and from a PDSE toa PDS 
The DEDSS data ser COPY command can be used to move a PDS and convert it to 


y D A 2 aera 
a PDSE. of vice versa: 


Printing for Diagnostic Purposes 
You can print DASD data to SYSPRINT or to a sequenual data set in print format. 
For data set printing. tracks are printed in logical sequence of the data set on the 
volume. not in the physical cylinder and head sequence. 


The DFDSS PRINT command ts used to print a single-volume non-VSAM data set, 
— me VSAM data set component, all or part of the VTOC, or ranges of 


eS 
St t 


CPaeons. 


Like devices huve the same track capacity and number of tracks per cylinder (for exainple, 3380 Standard and 3380 
Mode! D or E}. Unlike DASD devices have different track capacities, a different number of tracks per cylinder (for 
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example, 3350 and 3380), or both. 
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COMPRESS Command 


The COMPRESS command compresses partitioned data sets on a specified volume. 
Compressing removes unused space between members in a partitioned data set. This 
recovered space is then available for reuse at the end of the data set. Depending on 
the filtering criteria you specify, you can compress either all or some of the parti- 
tioned data sets. This command is useful for compressing system partitioned data 
sets before you apply maintenance (thus avoiding certain space-related abends). 


Note: You must not compress the data sets that contain DFDSS or IEBCOPY exe- 
cutable code. 


The actual PDS compression is done on the existing volume using the IEBCOPY 
utility. To prevent loss of data if the system or IEBCOPY abnormally ends during 
processing, back up volumes or data sets that meet the filtering criteria before using 
the COMPRESS command. 


COMPRESS cannot process partitioned data sets that: 


e Are unmovable 
¢ Contain track overflow records 
¢ Have no directory. 


COMPRESS Command Syntax 


»>>—COMpress-—-—( 2" 


FILterdd——(ddn) 
Foo——! 


aa 


D car CCtCt*~C~S 
eR ie | 


a a fa 
,unit 
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Optional Keywords 





LoynaLloc— WAIT (numsecs,numretries) 


PASsword—7— ( ddn 
Leswo——— 
| catname 
i /pswd 


dsn 





peel 


Explanation of COMPRESS Command Keywords 


salecead alt 
ek sealed: 


specifies that the data sets selected up to this point, by the processing of the 
INCLUDE and EXCLUDE keywords, are to be further filtered. To select the data 
set, all BY criteria must be met. See the separate discussions of INCLUDE and 
EXCLUDE for information on how these kevwords are specified. 


estes 


ddn 

specifies the name of the DD statement that identifies a volume whose partitioned 
data sets, if selected, are to be compressed. To assure correct processing, each of the 
DD statements corresponding to a DDNAME (ddn) must identify only one volume 
serial number. 


BY 


DDName 
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DYNALIloc 


DYNAM 


EXClude 


Filterdd 


‘COMPRESS Command 


LovnaLtoc— 


specifies dynamic allocation, instead of enqueue, to serialize the use of selected parti- 
tioned data sets. The data sets whose extents are to be relocated are serialized 
throughout COMPRESS. This allows cross-system serialization in a JES3/MVS 


environment. 


Consider: 


¢ The serialization is of value only when the dynamic allocation/JES3 interface is 
not disabled. 


e SVC 99 is used to serialize data sets. 


e Run time increases when DYNALLOC is used to serialize data sets (as opposed 
to enqueue) because overhead is involved in dynamic allocation and serialization 
across multiple processors. 


me se 1, 


ane 


specifies a dynamically allocated volume whose partitioned data sets, if selected, are 
to be compressed. If the volume is real (not virtual), it must be mounted and online. 
Consider using DYNAM instead of DD statements to allocate DASD volumes. 

This does not appreciably increase run time and permits easier coding of JCL and 
command input. 


volser 

specifies the volume serial number of a DASD volume to be processed. 

unit 

specifies the device type of a DASD volume to be processed. This keyword is 
optional. 


oe 





coe Ca. 


op, ( 


Sic teal 
dsn 


specifies the name of a data set to be excluded from the data sets selected by 
INCLUDE. Either a fully- or a partially-qualified data set name can be used. See 
the separate discussions of INCLUDE and BY for information on how these 
keywords are specified. 





Filterdd (ddn) 
FD 
ddn 
specifies the name of the DD statement that identifies the sequential data set or 
member of a partitioned data set that contains the filtering criteria to use. This is in 
the form of card-image records, in DFDSS command syntax, that contain the 
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INCLUDE, EXCLUDE, and BY keywords that complete the syntax of the COM- 
PRESS command. 


eral 


— 





Preba ; ea k 
BY (y(—schar, op, (yarg+)+) 
dsn 


specifies the name of a data set eligible to be compressed. Either a fully- or a 
partially-qualified data set name can be used. See “Filtering by Data Set Names” on 
page 10. If INCLUDE is omitted (but EXCLUDE or BY is specified) or if 
INCLUDE(**) is specified, a// partitioned data sets are eligible to be selected for 
compressing. See the separate discussions of EXCLUDE or BY for information on 
how these keywords are specified. 


> 


PASsword——( d ) 
reat 
euleine 
L /pswd 
sn 


specifies the passwords DFDSS is to use for selected password-protected data sets. 
(Password checking is bypassed for RACF-protected data sets.) This must be speci- 
fied only if: 


¢ You do not have the required RACF DASDVOL or RACF DATASET access. 
¢ The installation authorization exit does not bypass the checks. 
¢ You do not want to be prompted for the password. 


ddn 

specifies the name of the DD statement that identifies the sequential data set or 
member of a partitioned data set that contains data set names and their passwords. 
This data set must contain card-image records in DFDSS command syntax format. 


dsn{[pswd 
dsn is a fully-qualified data set name. pswd is its password. If no password follows 
the slash (/), dsn is treated as though it were ddn. 


Printing of actual data set passwords specified in your input command stream 1s sup- 
pressed in the SYSPRINT output. 


Note: When a system utility (such as IEBCOPY) is being used to perform the 
COMPRESS, the user must supply the password for each password-protected data 
set selected. 


tigen Dy Romnbe ati gag Ee Ra agantoa oe 


WAIT 


‘COMPRESS Command 


Car Gadest se nineeenies) = 


specifies to DFDSS the length of a wait in seconds and the number of retries to 
obtain control of a volume or data set. 


numsecs 
is a number from | to 255 that specifies the interval, in seconds, between retries. *’ 


numretries 
is a l- or 2-digit number that specifies the number of times an attempt to gain 
control of a volume or data set is to be retried. 


The default for numsecs,numretries is WAIT(2,2), which specifies two retries at 
2-second intervals. If you do not want to wait for a resource, specify 0 for either 
numsecs or numretries. 


Example of a COMPRESS Operation 


Compressing Selected Partitioned Data Sets 


//J30OB1 JOB accounting information,REGION=nnnnk 

//STEPL EXEC PGM=ADRDSSU 

//SYSPRINT DD SYSOUT=A 

//SYSIN DD. -* 

COMPRESS - 
DYNAM (338000) /* DYNAM ALLOC VOL 338000 iy Ars 
EXCLUDE (SYS1.**) /* EXCL. 'SYSI....%° DATA SETS */ - 

/* IF THEY MEET THIS CRITERION */ - 

BY((DSCHA EQ 0)) /* DATA SET WAS BACKED UP ars 

/* 


Compress partitioned data sets on volume 338000 if: 


e They are not system data sets (EXCLUDE(SYS1.**)), and 


e They have not been updated since the last time they were backed up (dumped). 
This ensures that the data set can be recovered if the system fails while COM- 
PRESS is running (DSCHA EQ 0). 
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CONVERTV Command 


The CONVERTV command is used to convert existing volumes to and from SMS 
management without data movement. The CONVERTV command performs three 
functions: | 


1. Lock volumes that are ready for c conversion to Ppeycats new eae set allocations 
* “(PREPARE keyword). ae eae acti 


2. Examine volumes identified by SMS to determine if they can be converted to 
SMS management (TEST keyword). No conversion is actually performed, but 
DFDSS identifies any data sets that cannot be converted to SMS management 
and why they cannot be converted. 


3. Perform conversion of volumes into or out of SMS management. Any condi- 
tions that prevent conversion are identified. 


Note: DFP Version 3 Release 1 or subsequent releases and RACF Facility Class 
authorization are required for CONVERTV. 


CONVERTV Command Syntax 


>>—CONVERTV——SMS 





errr 


| 

| 

| DODName—( er 

| — — 
| eee ree vol 5 aera | 


Optional Keywords I. SMS 








LRepETermi ne— 





INCAT Neal 


24 DFDSS: Reference 


end teed Ety f 


5 Taye Set ee rs ode ee ” A gist tt om weg BE oye 2 fog Fm gethonpeet ts a: + 9 a gases pe F vee oi Neate? 
ie i ih LS Ll ee) ee eG A eA ee Oa he ae SE EL ee ee ee ee. eet oC ee ee ee eee Se bt Ee Le eee ST eC © POS Se Coe Pi Ce cae eee CEL 


Explanation of CONVERTV Command Keywords 








ALLMulti 

ae bs 
NONSMS ALLMul ti 

specifies that cataloged, multi-volume data sets found on volumes identified in the 
DDNAME or DYNAM volume lists that have extents residing on volumes notin —_. 
the list will be processed successfully. If ALLMULTI is not specified, such data sets 
are not eligible for conversion. 
Note: For SMS processing, the first extent of a multivolume data set must reside on 
one of the volumes in the input volume list or that data set is not processed. This 
restriction does not apply to NONSMS processing. 

CATalog 
>——SMS 

nial 

specifies that if a data set’s catalog entry is not found in the standard order of ~ 
search, the data set is to be cataloged during the conversion. 
If the CATALOG keyword has not been specified, and a data set’s catalog entry is 
not found in the standard order of search, the data set is not converted. 
INCAT 
specifies input catalog(s) that are not in the standard search order. This allows 
non-VSAM data sets cataloged outside the standard order of search to be processed. 
catname 
specifies a fully-qualified data set name. 
If CATALOG is specified without INCAT, a single volume, non-VSAM data set 
cataloged outside the standard order of search might be cataloged in more than one 
place. 

DDName 
ee | 
ddn 
specifies the name of the DD statement that identifies a volume to be processed. 
This keyword is required when DYNAM is not specified. 

DYNAM 


ee ser | 


Leste 


specifies that a volume being processed must be dynamically allocated. If the 
volume is real (not virtual), it must be mounted and online. This keyword is 
required if DDNAME is not specified. 


volser 
specifies the volume serial number of a DASD volume to be processed. 
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NONSMS 


unit 
specifies the device type of a DASD volume to be processed. This keyword is 
optional. 


SN SS eS Se 


-. specifies that a volume and all of the data sets on that volume are to be converted . 


PREPare 


REDETermine 


SMS 


TEST 
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from SMS management. 


i ee 


specifies that a volume is to be prepared for SMS without conversion of data sets. 
This prevents the volume from changing prior to performing the full SMS conver- 
sion. After PREPARE is requested, the volume is placed in initial status and you 
cannot allocate new data sets. However, you can delete existing data sets. 


NONSMS must be specified to return the volume to non-SMS management. 


re a eee ip ei ye eg a oe 
REDETermine 


specifies that the SMS class information is to be reset for data sets previously con- 
verted to SMS management. REDETERMINE allows management class and 
storage class to be reset, but does not update the data class. 


If REDETERMINE is used with the TEST keyword, a report is produced specifying 
all data sets eligible for conversion, including those already converted. 


——S$M“s__-- 


specifies that a volume and all of the data sets on that volume are to be converted to 
SMS management. SMS is the default when SMS, NONSMS, or PREPARE is not 
specified. 


Lest 


specif:. that DFDSS is to verify that a volume and its data sets are eligible for con- 
version or for preparation. The TEST keyword functions just as if 
TYPRUN = NORUN had been specified on the JCL EXEC PARM field. 


Note: It is also possible to use TEST to verify that the ACS algorithms would 
process correctly because the resulting report indicates the classes associated with the 
various data sets on the volume. 


CONVERTV Command.- 


ne er Sh steers 


Examples of CONVERTV Operations 
Example 1: Using CONVERTV to simulate conversion 


//30B1 JOB accounting information, REGION=nnnnk 
//STEP1 EXEC PGM=ADRDSSU 

//SYSPRINT DD SYSOUT=A 

//SYSIN DD * 


CONVERTV SMS . me ale 
DYNAM( (VOLO01 , 3380) , (VOLO02 , 3380) (VOLO03) ) - 
TEST 

/* 


The preceding example uses the TEST keyword to simulate conversion. The TEST 
keyword produces a report that indicates whether the three volumes (VOL001, 
VOL002, and VOL003) can be converted to SMS management. 


Example 2: Using CONVERTYV to go to SMS 


//J3OB1 JOB accounting information, REGION=nnnnk 
//STEP1 EXEC PGM=ADRDSSU 

//SYSPRINT DD SYSOUT=* : 

//DVOL1 DD UNIT=SYSDA, VOL=SER=338001 , DISP=0LD 

//DVOL2 DD UNIT=SYSDA, VOL=SER=338002 , DISP=0LD 

//SYSIN DD * 


CONVERTV - 
DDNAME(DVOL1,DVOL2) - 
SMS - 
INCAT(SYS1.ICFCAT.V338002) - 
ALLMULTI - 
CATALOG 
f[® 


The non-SMS volume 338002 and the SMS volume (in INITIAL state) 338001 are 
converted to SMS. The volume 338001 was placed in the initial state by the storage 
administrator. Regardless of where the data sets reside, all multivolume data sets 
whose first extent is on volume 338001 or 338002 are processed. In addition, there 
are some data sets on volume 338002 cataloged in the user catalog 
SYS1.ICFCAT.V338002. These data sets are uncataloged from the user catalog and 
cataloged in the standard order of search. The INCAT keyword provides access to 
the user catalog because STEPCAT is not allowed. 


Example 3: Using CONVERTV to go from SMS 


//J30B1 JOB accounting information,nnnnk 
//STEPI EXEC PGM=ADRDSSU 

//SYSPRINT DD SYSOUT=* 

//SYSIN OD a 


CONVERTYV - 
DYNAM(338003) - 
NONSMS 

/* 


This example removes a volume that is SMS-managed to non-SMS control. 
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COPY Command 


With the COPY command, you can copy data from one DASD volume to another. 
You can copy data sets between DASD of like or unlike device type or a full volume 
or ranges of tracks between DASD of like device type. 

DFDSS offers two ways to process COPY commands: 


¢ Logical processing is data-set oriented, which means it a against dave sets 
and volumes independently of physical device format. 


¢ Physical processing can operate against data sets, volumes, and tracks, but is ori- 
ented toward moving data at the track-image level. 


The processing method is determined by the keywords specified on the command. 


For information on how to use the COPY command, see Data Facility Data Set 
Services: User’s Guide. 


COPY Command Syntax for DATASET 


Pe ie aiset ( oT 
D alll 


FILterdd——(ddn) 
Fo. 














OUTDDname——(ddn) 
000 ——_ 


UTDYna ee iF 


7) 
ODY sunit 


Additional aie as with DATASet 


sisal 


~~ 


Eeialal 


call schar,op, ( ca) 
lice hI —schar,o ier 


LO 












° 


pee | 


ed 


INClude( ilk 


leon Lt schar,op, a cl 





Sag 


~ 
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Optional Keywords Used with DATASet 









ALLData~( al 
ALLData~(*) 


| CANcelerro im 
BYPASSACS (ydsn+) eels ) 


-_ PDSE( fal i 
_ a 






salt 


PDSE la 


DYNALToc FORce CAlaoo DELete 
RECATalog(newcatname) 
RECATalog(*) 





pee — hh —— 


am 


oan | Areas )- 
sunit 


IDY 


| 
LOGINDDname ‘lade ) 


fe 


Riel eae 
»unit 


ENtity(modeldsn) 
avelean(aicer) 


GMTCLAS (management-class-name) 
NULLMGMTCLAS 


mene ha 
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[password ddn J 
PswD—— 
ee 
L | /pswd 
sn 






eae 








ELBLoc eee 


RELBLKA 







RENAMEUncondi tional 
RENUNC 


(pfx) 


stare LspHere— Lreral loc—(~7-BLK J 
SHR Es 









TRK 


SOURCE 
SRC 





TOLerate-(——I0ERro 





aeve~* COPY Command 





TRACKOverflo fal 
Ls aeaieches 


UNCATalog AIT (numsecs ,numretries) Ritecheck 
RC. 


COPY Command Syntax for FULL or TRACKS 


p>—COPy FULL 
FUL 






ne J 


TRACKS 
TRKS—— nl 













(ddn) 
pees 
OUTDYna {vol is OE 

“eae ,unit 
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Optional Keywords a with FULL 
CE 


CUr yz Command 


Leen © ~ oe ay 





eee 


ALLData~(*) 





OPYVolid- PASsword——( ddn ) 
—CPYV pswo——| 


catname 
[ /pswd 
dsn 





| PuRge 
PRG 


_TOQLerate—(—-IOERror—) 





—WAIT(numsecs ,numretries) WRI techeck— 
RC 


Optional Keywords ra with TRACKS 








miele if 





OUTTRKS hl 
2c2 
»h2 
L_password——(——ddn ) 
Losyp———l | 
catname i 
[ /pswd 


dsn 





—TOLerate~(—IOERror—) 


Liat niadece HURPEERIEOE. arr techeck-| 
WRC 
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| Explanation of COPY Command Keywords ; 


ALLData 


ALLExcp 


COPY Command... . 





le 


ALLData-(*) 





dsn 
specifies the name of a SAM (DSORG=PS or PSU) or PAM (DSORG=PO or 
POU) data set or a data set with a null DSORG field, for which: 


e When the source data set and the target data set are on the same device type, all 
allocated space on the source is to be allocated and copied to the target for 
SAM data sets or for PDS load modules without REBLOCK specified. When 
DFDSS copies a PDS that is not a load module or when DFDSS copies a PDS 
load module with REBLOCK specified, all allocated space on the source is to be 
allocated on the target. However, only the used space is copied. 

e When the source data set and the target data set are different device types, all 
allocated space on the source is to be allocated on the target but only used space 
is to be copied. 


See Figure 4 on page 56 for results when you use ALLEXCP/ALLDATA. 


Note: Any time a data set can have data beyond the limits described by the DSCB 
DSILSTAR field, or contains a null DSILSTAR field, or is a first or intermediate 
volume of a multivolume data set that contains a null DS1LSTAR field, you must 
specify ALLDATA(dsn) to copy all its data. JES2/JES3 data sets can have these 
characteristics, as can CICS journal and MSVCJRNL data sets. 


* (asterisk) 
specifies that, for all SAM and PAM data sets and data sets with a null DSORG 
field whose DSILSTAR field is nonzero: 


¢ When the source data set and the target data set are on the same device type, all 
allocated space on the source is to be allocated and copied to the target for 
SAM data sets or for PDS load modules without REBLOCK specified. When 
DFDSS copies a PDS that is not a load module or when DFDSS copies a PDS 
load module with REBLOCK specified, all allocated space on the source is to be 
allocated on the target. However, only the used space is copied. 

e When the source data set and the target data set are on different device types, all 
allocated space on the source is to be allocated on the target, but only used 
space is to be copied. 


L-arrexce— 
ALLX 
specifies that, for data sets whose DSCB DSILSTAR field is zero (SAM or PAM 


data sets or data sets with a null DSORG field): 


e When the source data set has an EOF as its first record, all allocated space on 
the source is to be allocated and an EOF is copied. 

¢ When the source data set does not have an EOF as its first record, the data set 
is not processed. 


See Figure 4 on page 56 for results when you use ALLEXCP/ALLDATA. 
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ALLMul ti 


specifies that cataloged, multivolume data sets that have volumes missing from the 
LOGINDDNAME or LOGINDYNAM volume list will be copied in their entirety. 
To qualify for ALLMULTI processing, a data set must have at least one primary 
volume specified in the LOGINDDNAME or LOGINDYNAM list, and it must be 
cataloged. Data from the missing volume(s) will be copied for applicable data sets. 


Note: ALLMULTI is valid only when LOGINDDNAME or LOGINDYNAM is 
specified. 


“rlcoec C}§——7» 
INCLUDE ar EXC] ial 


specifies that the data sets selected up to this point, by the processing of the 
INCLUDE and EXCLUDE keywords, are to be further filtered. To select the data 
set, all BY criteria must be met. See “Filtering by Data Set Characteristics” on 
page 12 for further information on BY filtering. 


ese at 


specifies that the Automatic Class Selection (ACS) routines are not invoked to deter- 
mine the target data set class names. In order to bypass ACS filtering, the user must 
have RACF Facility Class authorization. 


See “Assignment of Class Names by Using RESTORE and COPY” on page 120 for 
information on the assignment of class names by using COPY. 


dsn 
specifies a fully-qualified data set name. 


DcaNce! sae 


specifies that the COPY is to be ended if a permanent read error, such as a data 
check, occurs. If this keyword is not specified and a permanent read error occurs, 
the track in error is not copied and the COPY continues. On COPY operations in 
which a utility performs the copy, DFDSS ignores this keyword. CANCELERROR 
has no effect on the following types of errors on a DASD volume: 


Equipment check 
Command reject 
Intervention required 
Busout parity. 


| -CATalog . 


COPYVolid 
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CATalog 
RECATalog(newcatname) 
RECATalog(*) 


specifies that on a data set COPY. DFDSS is to catalog data sets that it allocates. 


CATALOG 
catalogs the target data set as determined by the standard catalog search order. This 
is the default for VSAM, multivolume data sets, and SMS-managed data sets. 


RECATALOG(*) 
catalogs the target data set in the same catalog that points to the source data set. If 
the source data set was not cataloged, the new data set is not cataloged either. 


RECATALOG(newcatname) 
catalogs the target data set in the newcatname catalog. 


Notes: 


1. Be careful when using RECATALOG(newcatname) because the target data set 
may be cataloged outside of the standard order of search. 


2. CATALOG or RECATALOG fails if the target data set is already cataloged in 
the same catalog and DELETE, RENAMEU, or UNCATALOG is not speci- 
fied. RECATALOG is ignored for SMS targets. 


3. An alternate index (AIX) is always cataloged in the same catalog as its associ- 
ated base cluster. If the base cluster is recataloged, the AIX is recataloged. 


4. If you omit the CATALOG or RECATALOG keyword for a non-VSAM data 
set, the target data set will be uncataloged. 


Lcopyvo i] 
CPYV 


specifies that the volume serial number (VOLID) from the input DASD volume is to 
be copied to the output DASD volume. This applies to full copy operations and to 
tracks copy operations if track 0 is copied. 


Note: COPYVOLID is required for a full-volume COPY of an SMS-managed input 
volume. 


When the volume serial number is changed by using a COPYVOLID keyword or if 
the volume serial of the dumped volume and the volume to be restored to are dif- 
ferent, profiles are not built for the RACF-protected data sets on the restored 
volume or for the KACF DASDVOL for the RACF-protected DASD volume. 


When the volume serial number on a DASD volume is changed, the volume serial 


field in the UCB of the receiving volume is cleared and the operator is notified. The 
operating system then initiates a demount of the volume. 
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CONVERT 


DATASet 


DELete 
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ae uae : : 
| ; 
_ th 


PDS ia 


POSE ( Mi 
CONVERT(PDSE(dsn)) 
specifies that the PDS(s) listed in the dsn are to be converted to PDSE 


CONVERT (PDS(dsn)) 
specifies that the PDSE listed in the dsn are to be converted to PDS(s). 






Notes: 


1. The CONVERT keyword requires at least MVS/DFP Version 3 Release 2 and 
MVS/SP Version 3 Release 1.0E. 


2. If the target data set is a PDSE, it must be SMS-managed; and it must be a data 
library (non-load modules). 


eye ee ee 
DS 


specifies a data set COPY operation using filtering. See Chapter 2, “Choosing the 
Data Sets You Want Processed—Filtering” on page 9 for an explanation of the fil- 
tering process used. Unless DATASET is specified with ALLDATA or ALLEXCP, 
only used tracks are copied for SAM and PAM data sets and for data sets with a 
null DSORG field (for example, JES2/JES3 data sets). If the free space map in the 
VTOC is invalid, all tracks are copied. The FILTERDD or INCLUDE keyword 
must be substituted when this choice is selected. 


Note: VSAM catalogs are not supported for data set processing. If VSAM were 
are processed, the results can be unpredictable. 


Chetete— 


deletes VSAM and non-VSAM data sets from the source volume after a successful 
copy. This moves, in effect, a data set from one volume to another. The data sets 
are scratched and uncataloged. 


Notes: 


1. If you do not specify DELETE when copying cataloged data sets, the target 
data set must either be cataloged (with RECATALOG) in a different catalog or 
renamed (with RENAMEDV). 


ty 


. Unexpired source data sets are deleted only if you also specify PURGE. 


3. Even if PROCESS (SYS1) is specified, SYS1.VVDS and SYS1.VTOCIX data 
sets cannot be c. pied and deleted. 


4. Do not specify SHARE if you specify DELETE. 


DYNALIoc 


EXClude 


FiLterdd 


FORce 


COPY Command 


5. If DFDSS encounters a damaged PDS during logical data set COPY, it displays 
messages indicating the nature and relative location of the problem. In order to 
maintain complete data integrity, DFDSS does not delete the source data set. 
The COPY of the data set fails, and the target is deleted. In order to copy and 
delete a damaged PDS, use the NOPACKING keyword. 


a a ae ee 
OYNALI oc 


specifies dynamic allocation, instead of enqueue, to serialize the use of data sets. 
The data sets whose extents are to be relocated are serialized throughout COPY. 
This allows cross-system serialization in a JES3/MVS environment. 

Consider: 


e The serialization is of value only when the dynamic allocation/JES3 interface is 
not disabled. 


e SVC 99 is used to serialize data sets. 


e Run time increases when you use DYNALLOC to serialize data sets (as opposed 
to enqueue) because overhead is involved in dynamic allocation and serialization 
across multiple processors. 


taal 





dein te 
dsn 


specifies the name of a data set to be excluded from the data sets selected by 
INCLUDE. Either a fully- or a partially-qualified data set name can be used. See 
the separate discussions of INCLUDE and BY for information on how these 
keywords are specified. 





FILterdd——(ddn) 
Leo] 


ddn 

specifies the name of the DD statement that identifies the sequential data set or 
member of a partitioned data set that contains the filtering criteria to be used. This 
is in the form of card-image records, in DFDSS command syntax, that contain the 
INCLUDE, EXCLUDE, and BY keywords described below. 


Note: You must use FILTERDD when you have more than 255 entries in 
INCLUDE, EXCLUDE, or BY list keywords. 


Lrorce-! 


specifies that DFDSS copy one or more unmovable data sets to a like or unlike 
device type. Unmovable data sets are those allocated as absolute track (ABSTR) or 
as unmovable (PSU, POU, DAU, or ISU). FORCE applies to ISAM data sets only 
when they are allocated with the unmovable attribute. The allocation attribute, 
unmovable or ABSTR, is carried over to the output volume. 
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FULL 


INCAT 
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When copying to like devices, DFDSS copies the data sets to the same track locations 


on the target volume. In this case, FORCE is not required if all the following condi- 
tions are true: 


e The operating system is MVS/XA DFP Version 2 Release | or a later release. 
e The target volume uses an indexed VTOC. 
e The space where the unmovable data set is to reside is available. 


If any of these conditions is not true, DFDSS does not copy any unmovable data 
sets unless FORCE is specified. In this case, DFDSS places the unmovable data sets 
in any available location. 


When copying to unlike devices, you must specify FORCE. The yamovadle data sets 
are placed in any available location. 


sa alee 
specifies that an entire DASD volume is to be copied. This is the default. . Unallo- 
cated tracks are not copied. Unless specified by ALLDATA or ALLEXCP, only the 
used (rather than allocated) tracks are copied for SAM data sets, PAM data sets, 
and for data sets with unknown data set organization (for example, JES2/JES3 data 
sets with a null DSORG field). If the VTOC has errors, all tracks are copied. Used 


tracks consist of the tracks from the beginning of the data set to the last-used track 
(as indicated in the DSILSTAR field of the Format 1 DSCB). 


Notes: 
1. You cannot specify SHARE or TOL(ENQF) for FULL operations. 


2. VSAM catalogs are not supported for full volume processing. If VSAM catalogs 
are processed, the results can be unpredictable. 


a I. at 


specifies one or more user catalogs to be searched before the standard order of 
search for locating data sets. STEPCAT and JOBCAT are not allowed for proc- 
essing SMS-managed data sets. This keyword allows you to identify specific source 
catalogs. To specify INCAT, you must have the proper RACF Facility Class 
authorization. Refer to Resource Access Control Facility (RACF) Security 
Administrator’s Guide for additional information: 


catname 
specifies a fully-qualified catalog name. 


INClude 


INDDname 


INDYnam 


COPY Commani 








ere e 





eae [ol | 
BY (y(-schar,op, (yarg+)-) 
dsn 


specifies the name of a data set eligible to be copied. Either a fully- or a partially- 
qualified data set name can be used. See “Filtering by Data Set Names” on 

page 10. If INCLUDE is omitted (but EXCLUDE or BY is specified) or 
INCLUDE(**) is specified, a/l data sets are eligible to be selected for copying. 





INDOname al 
oe: 


ddn ; 

specifies the name Of the DD statement that identifies a volume to be copied. For a 
data set COPY, you can specify multiple names (that is, multiple volumes), separated 
by commas. For single-volume data sets, each of the DD statements corresponding 
to a DDNAME (ddn) must identify only one volume serial number 


Note: If no input volume(s) is specified for a data set COPY, DFDSS selects from 
all data sets cataloged in the catalogs accessible through the standard search order. 
If either INDDNAME or INDYNAM is specified, DFDSS still uses the standard 
catalog search order, but it selects data sets only from the specified volume(s). For 
multivolume data sets, use LOGINDDNAME or LOGINDYNAM with 
ALLMULTI. 


When DFDSS invokes IEHMOVE to copy multivolume non-VSAM data sets, 
IEHMOVE requires that the first DD statement in the job stream must identify all 
input volumes. DFDSS requires separate DD statements for the input volumes. To 
accommodate both requirements, you must code your JCL as follows: 


//INDD1 DD UNIT=(SYSDA,2) , VOL=SER=(VOL1,VOL2) ,DISP=SHR 
//INDD2 DD UNIT=SYSDA,VOL=SER=VOL2 ,DISP=SHR 


and code your DFDSS control statement: 
COPY LOGINDD(INDD1,INDD2) ... 


INDYna ee 
sunit 


IDY 





specifies that the volume(s) to be copied is to be dynamically allocated. If the 
volume is real (not virtual), it must be mounted and online. Only one volume is 
allowed for a full or tracks COPY; one or more volumes are allowed for a data set 
COPY. Consider using INDYNAM instead of DD statements to allocate DASD 
volumes. This does not appreciably increase run time and permits easier coding of 
JCL and command input. 


volser 
specifies the volume serial number of a DASD volume to be copied. 
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LOGINDDname 


LOGINDYnam 


MENtity 
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unit 
specifies the device type of a DASD volume to be copied. This keyword is optional. 





specifies that data sets be selected from the specified volume or volumes (which you 
can also do by specifying INDDNAME or INDYNAM) and also allows you to 
specify ALLMULTI (which cannot be done with INDDNAME or INDYNAM). 


ddn 

specifies the name of the DD statement that identifies a volume that contains the 
data set(s) to be copied. For single-volume data sets, each of the DD statements 
corresponding to a DDNAME (ddn) must identify only one volume serial number. 
See the note under LOGINDYNAM. 


oe 
,unit 


LIDY 





specifies that the volume(s) that contains the data set(s) to be copied is dynamically 
allocated. If the volume is real (not virtual), it must be mounted and online. 


volser 
specifies the volume serial number of a DASD volume to be copied. 


unit 
specifies the device type of a DASD volume to be copied. This keyword is optional. 


Note: If neither LOGINDDNAME nor LOGINDYNAM is specified, DFDSS 
selects from all data sets cataloged in the catalogs accessible through the standard 
search order. If either LOGINDDNAME or LOGINDYNAM is specified, DFDSS 
still uses the standard catalog search order, but it selects data sets only from the 
specified volume(s). A multivolume data set that has extents on volumes not speci- 
fied with LOGINDDNAME or LOGINDYNAM is copied only if you specify the 
ALLMULTI keyword. 


Linenti ty (model See 
VOLser(voiser) 


specifies, for RACF-protected data sets, an entity (modeldsn) and, optionally, the 
serial number of the volume containing that entity (volser). These keywords are used 
to define the data sets to RACF. Specification of MVOLSER is optional for one of 
the following: 


¢ When the model entity (MENTITY) is cataloged in an integrated catalog facility 
catalog. 


¢ When a non-VSAM data set is cataloged in the standard catalog search order. 


When MVOLSER is specified for a VSAM model entity, vo/ser must be the volume 
serial number of the catalog in which the model entity is cataloged. If these 
keywords are not specified, DFDSS defines the data set to RACF by modeling the 
target profile after the source data set, if the source is discretely protected (for 
details, see Figure 3 on page 43). Target data sets (preallocated or nonpreallocated) 


MGMTCLAS 


NOPACKing 


COPY Command 


are RACF-protected only if the corresponding source data sets were so protected. If 
a source data set is protected with a generic profile, RACF generic profile checking 
must be activated prior to invoking COPY. 


If you do not specify MENTITY and you have RACF Release 1.5 or later installed, 
Figure 3 on page 43 shows how profiles must be defined. 


GMTCLAS (management—class—name)— 
NULLMGMTCLAS 
NMC: 


specifies the user-desired management class that will replace the source management 
class as input to the ACS routines. You must have the proper RACF authority for 

the management class specified. The keyword itself does not require RACF authori- 
zation. 


NULLMGMTCLAS specifies that the input to the ACS routines will be a null man- 
agement class rather than the source data set’s management class. 


MGMTCLAS and NULLMGMTCLAS are mutually exclusive; you cannot specify 
these keywords together. . 


Notes: 


1. All SMS-managed data sets specified in the BYPASSACS keyword will be 
assigned the specified management class because the ACS routines will not be 
invoked. Non-SMS-managed data sets do not have a management class. 


2. See “Assignment of Class Names by Using RESTORE and COPY” on page 120 
for information on the assignment of class names using COPY. 


eens 


specifies that DFDSS is to allocate the target data set only to the same or like device 
types as the source data set is allocated on and that DFDSS is to use track level I/O 
to perform data movement. This results in an exact track-for-track image of the 
source data set on the target volume. 


dsn 
specifies the fully- or partially-qualified name(s) of a PDS to be processed. 


NOPACKing is only valid with a PDS. If REBLOCK is specified, REBLOCK is 
ignored for the data set. If the data set is specified with CONVERT(PDSE(), 
NOPACKing is ignored for the data set. 


A PDS copied or restored by using NOPACKing will not be compressed during data 
movement. 


NOPACKing can be used for a damaged PDS that is currently usable by an applica- 


tion but would be made unusable by compression or other rearrangement of the 
physical layout of the data. 
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OUTDDname 


OUTDYnam 


OUTTRacks 


PASsword 
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Louroonane (dan) 
0D 


ddn 

specifies the name of the DD statement that identifies the output DASD volume. 
To assure correct processing, each of the DD statements corresponding to a 
DDNAME (ddn) must identify only one volume serial number. For a data set 
COPY, you can specify multiple names separated by commas. 





OUTDYna (¥(vol | 
eee »unit 


specifies that the output DASD volume is to be dynamically allocated. If the 
volume is real (not virtual), it must be mounted and online. Only one volume is 
allowed for a full or tracks COPY; one or more volumes are allowed for a data set 
COPY. 


volser 
specifies the volume serial number of the volume. 


unit 
specifies the device type of the volume. This keyword is optional. 


army dea h 


OUTTRKS 





specifies, for a tracks COPY, the cylinder (cc) and head number (hh) on the output 
volume to which the tracks from the input volume are to be copied. If you do not 
specify OUTTRACKS, the tracks are copied to the place on the output volume 
where they were on the input volume. 


PASsword——( ddn ) 
ps 
catnam 
L-/osud 
sn 


specifies the passwords that DFDSS is to use for password-protected data sets. 
(Password checking is bypassed for RACF-protected data sets.) This is required 
only when: 


¢ You do not have the required RACF DASDVOL or RACF DATASET access. 
¢ The installation authorization exit does not bypass the checks. 
¢ You do not want to be prompted for the password. 





Passwords must be specified for data sets as follows: 


¢ Read passwords for source data sets when DELETE is not specified. 
¢ Alter passwords for target data sets when DELETE is specified. 
e Master passwords for catalogs. 


COPY Command 


Password checking is done at the cluster level for VSAM data sets. Passwords for a 
tracks COPY are required only for the data sets on which the requested ranges fall. 


ddn 

specifies the name of the DD statement that identifies the sequential data set, or 
member of a partitioned data set, that contains data set names and their passwords. 
This data set must contain card-image records in DFDSS command syntax format. 


dsn|[pswd 
dsn is a fully-qualified data set name. pswd is its password. If no password follows 
the slash (/), dsn is treated as though it were ddn. 


catname|pswd 


catname is a fully-qualified catalog data set name. pswd is its password. This is 
supported for VSAM data sets only. 


Printing of actual data set passwords specified in the input command stream is sup- 
pressed in the SYSPRINT output. 


When a system utility is being used to perform the DFDSS COPY, the user must 
supply the password for each password-protected data set selected or have the 

proper RACF data set access authority. Figure 3 on page 43 shows how profiles 
must be defined. 


No No RENAME RENAME 
RENAME RENAME Keyword Keyword 
Keyword Keyword No DELETE 
No DELETE DELETE Keyword 
DELETE Keyword Keyword 
Keyword 
Unprotected No profile No profile No profile No profile 
source to define. to define. to define. to define. 
Generic Leave Leave Leave Leave 
profile for source source source source 
source profile. No profile. No profile.4 profile.¢ 
target target 
profile to profile to 
define. define. 
Discrete Leave Delete Leave Delete 
profile for source source source source 
source profile. profile. profile. profile. 
Define dis- Define dis- Define a Define a 
crete target crete target discrete discrete 
profile.s profile.s target target 
profile.5 profile.5 


Figure 3. Defining Profiles When RACF 1.5 or Later Is Installed 


4 Issue RACHECK to determine if a generic or discrete profile already exists for the renamed target. If so, there is 
no profile to define. If not, a discrete profile will be defined. DFDSS gets the volser from the data set serial 
number field in the Format 1 DSCB. If, for instance, the volume has been clipped and renamed, ensure that this 
field is correct. 


5 When a discrete profile exists for a preallocated target data set, that profile is not deleted and no new profile is 
defined. 
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PERCENTUtilized 


PROCESS 


PURge 


REBLock 
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PERCENTUti lized dh 
pa lanibesii es 


specifies that DFDSS must stop allocating data sets to the target volume(s) when the 
allocated space reaches n percent of the total space on the target volume. The 
default value is 100. Specify more than one 7 if you have more than one target 
volume (for instance, a volume for overflow). This keyword is used as a guide only 
and might not be precise for all situations. This keyword might be ignored by 
DFDSS for VSAM data sets allocated to multiple target volumes. 


i SYS1 “ 





specifies that DFDSS is to allow data sets with a high-level qualifier of SYS1 to be 
copied to a preallocated target and that SYS1 data sets can be deleted. However, 
even if DELETE is specified, SYS1.VVDSs and SYS1.VTOCIXs are not copied and 
deleted. To specify PROCESS, you must have the proper RACF Facility Class 
authorization. Refer to Resource Access Control Facility (RACF) Security 
Administrator’s Guide for additional information. 


PROCESS also specifies that DFDSS allows undefined DSORG data sets to be 
copied to an unlike target with a larger capacity. Refer to Figure 4 on page 56 to 
discern the action taken by DFDSS. 


Leurce| 
PRG—— 
specifies, for a full or tracks COPY, that unexpired data sets on the target volume 


can be overlaid. If PURGE is not specified and unexpired data sets reside on the 
target tracks, the COPY operation is ended. 


For a data set COPY, PURGE specifies that unexpired source data sets are to be 
deleted after they are successfully copied. This keyword is only valid when 
DELETE is also specified. 


en 


specifies that DFDSS is to reblock one or more of the selected SAM or PAM data 
sets unless otherwise overridden by the user reblock exit routine. 


dsn 
specifies the fully- or partially-qualified name(s) of a SAM or PAM data set to be 
copied and reblocked. 


RELBlockaddress 
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If a PDS is also specified in NOPACKing, the PDS is not reblocked. The following 
data sets will not be eligible for reblocking: 


¢ Non-load module PAM data sets with NOTE lists 
e SAM or PAM data sets with RECFM = U. 


When copying PAM load modules to an unlike device, DFDSS uses IEBCOPY with 
COPYMOD specified. This may result in a reblocked data set. When copying to a 
like device, IEBCOPY is used. 


Under MVS/XA DFP Version 2 Release 2 or later release, DFDSS uses the 
DASDCALC macro to determine the optimal block size for the target. The 
reblocking method used, DFDSS or DASDCALLC, is presented to the installation 
reblock exit. Track overflow data sets can be reblocked by using either method. 





RELBlockaddress ik 
RELBLKA-————— 


identifies the BDAM data sets whose names match the fully- or partially-qualified 
names specified (dsn). These BDAM data sets are organized by relative block 
address instead of TTR and are to be copied block by block without maintaining the 
relative track and record number for each record, provided the blocks fit on the 
tracks of the target volume. This keyword is ignored for TTR-organized BDAM 
data sets and for BDAM data sets with standard user labels. 


RENAMEUnconditional 













RENAMEUnconditional 
RENUNC 


(pfx) 


Teas 
(pfx), A eacecdh 


specifies that the data set must be copied with the new name, regardless of whether 
the data set exists on DASD with the old name. If the data set exists on the target 
volume with the new name, an allocation error occurs, and the data set is not 
copied, regardless of whether REPLACE is specified. 






pfx 

specifies the prefix used to replace the first-level qualifier of the data set name. It is 
optional, but if specified, must be the first parameter in the list of subkeywords. The 
prefix is used only if the (on,nn) parameters are not specified or the old name filters 
do not match the data set name. 


on 
specifies the old name to be used as a filtering criterion to check if it matches the 
data set name. 


nn 
specifies the new name to be used to derive the new data set name when the data set 
name matches the corresponding old name filtering criterion. 


The syntax rules for pfx (prefix), on (old name), and nn (new name) are the same as 


in the RENAME keyword in a RESTORE operation. See “REName” on page 112 
under the RESTORE command for more information. 


Chapter 3. Syntax—Function Commands 45 


COPY Command 


REPlace 


SHAre 


SPHERE 


STORCLAS 
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Deepiace— , 


specifies that DFDSS is to search the target volumes for usable preallocated data 
sets. If no preallocated target is found, DFDSS attempts to allocate a data set. 


Note: If REPLACE is specified with COPY, the classes already associated with the 
preallocated data set remain the same. 


[stare 

SHR 

specifies that DFDSS is to share the data sets to be copied for read access with other 
programs. 


SHARE and FULL are mutually exclusive; you cannot specify these keywords 
together. 


Do not specify DELETE if you specify SHARE. You must have exclusive control 
over data sets that are to be deleted; SHARE does not require such exclusive 
control. 


L spuere— 


specifies that, for any VSAM cluster copied, all associated AIX clusters and paths 
are to be copied. Individual names of sphere components do not need to be speci- 
fied. Only the base cluster name is required. 


STORCLAS (storage-class—name) 
NULLSTORCLAS 
NSC 


specifies the storage class that you want to replace the source storage class as input 
to the ACS routines. You must have the proper RACF authorization for the storage 
class specified. The keyword itself does not require authorization. 


NULLSTORCLAS specifies that the input to the ACS routines is to be a null 
storage class rather than the source data set’s storage class. 


STORCLAS and NULLSTORCLAS are mutually exclusive; you cannot specify 
both keywords simultaneously. See “Assignment of Class Names by Using 
RESTORE and COPY” on page 120 for information on assigning class names by 
using COPY. 


Note: If BYPASSACS(dsn) is specified, also all data sets that pass the 
BYPASSACS selection criteria are guaranteed the specified storage class. The com- 
bination of NULLSTORCLAS and BYPASSACS(dsn) forces the selected data sets 
to be non-SMS. . 


TGTAlloc 


TGTGDS 
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TGTA] 1loc—(—-BLK ) 
CYL 
TRK 
SOURCE 
SRC 


specifies how DFDSS is to allocate the target data set. 


BLK 
specifies to allocate by blocks. 


CYL 
specifies to allocate by cylinders. 


TRK 
specifies to allocate by tracks. 


SOURCE/SRC 
specifies to allocate with the same space allocation type as that of the source data 
set. 


Notes: 


1. If the TGTALLOC keyword is omitted, the target allocation defaults to 
SOURCE. 


2. If SRC is specified and if the source data set is allocated by cylinder or if CYL 
is specified, then the final VSAM allocation might be different from the 
requested one because of VSAM allocation rules. 


3. If BLK is specified for VSAM data sets, TRK is used instead. The final VSAM 
allocation might be different from the requested one because of VSAM allo- 
cation rules. 


iow DEFERRE aad! 


ACTIVE 
ROLLEDOFF 
SOURCE 
SRC 


specifies in what status, during a data set operation, that DFDSS is to place non- 
preallocated SMS-managed GDG data sets: 


DEFERRED 
specifies that the target data set is to be assigned the DEFERRED status. 


ACTIVE 
specifies that the target data set is to be assigned the ACTIVE status, for example, 
rolled into the GDG base. 


ROLLEDOFF 
specifies that the target data set is to be assigned the rolled-off status. 


SOURCE/SRC 
specifies that the target data set is to be assigned the same status as that of the 
source data set 
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Notes: 


1. If DELETE is specified without RENAMEUNCONDITIONAL while proc- 
essing SMS-managed generation data sets, the TGTGDS keyword is ignored and 
the source GDS status is copied to the target. 


2. The requested target status of generation data sets must not violate generation 
data group rules. 


roteratent IOERro ‘= 


fi ENQFailure 
ENQFai lure 
IOERro 


specifies that DFDSS tolerates certain error conditions. For a COPY (except of a 
user catalog) in which a utility performs the copy, this keyword is ignored. 


ENQFailure 
specifies that data sets are to be processed even though shared or exclusive access 
fails. 


ENQF and FULL 
are mutually exclusive; you cannot specify these keywords together. 


For more information on TOL(ENQF), see Appendix B, “Serialization and Authori- 
zation Checking” on page 165. 


IOERROR 

specifies that if the input volume can be opened, DFDSS is to continue copying even 
though permanent input errors (busout parity and equipment checks only) occur. 
DFDSS will end after 100 errors when this keyword is specified. The default is to 
end on permanent input errors. On a data set COPY in which a utility performs the 
copy, DFDSS ignores this keyword. 


Note: TOL(IOERror) is ignored if CANcelerror is specified. 


TRACKS i : 


TRKS hl 





C2 
»h2 


specifies ranges of tracks to be copied (that is, a tracks COPY). 


cl ,hl 
specifies the cylinder and head number of the beginning of the range. Specify 
hexadecimal numbers as X'cl' or X'hl'. 


c2,h2 

specifies the cylinder and head number of the end of the range. Specify hexadecimal 
numbers as X'c2' or X'h2'. The c2 must be greater than or equal tocl. Ifc2 
equals cl, h2 must be greater than or equal to hl. 


TRACKOverflow 


UNCATalog 


WAIT 
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DFDSS verifies that the range is within the limits of the device. If you do not 
specify all four values for a range, DFDSS provides the missing values unless the 
omitted value causes a syntax error. No intervening values can be omitted. For 
example: 


Specified Results 


None Syntax error 

cl c1,0,cl,maximum head number 
cl ,hl cl,hl,cl,maximum head number 
cl,hl,c2.~—cl,hl,c2, maximum head number 
cl,,c2 Syntax error 

Al Syntax error. 








dah 
dsn 


specifies the name of data set(s) in which track overflow records are present but are 
not indicated by the Format 1 DSCB. The TRACKOVERFLOW keyword is not 
needed for data sets indicated as having overflow records. When you perform a 
COPY to an unlike device and the target device supports track overflow, specifying 
TRACKOVERFLOW allows DFDSS to correctly track-pack data sets. It sets the 
target’s Format | DSCB to indicate that overflow records are present. 


Luncatat og 


specifies that DFDSS is to uncatalog but not scratch successfully copied non-VSAM 
data sets that are currently cataloged on the source volume. Any data set that is not 
a user catalog and has a name beginning with SYSI1. cannot be uncataloged. 
UNCATALOG is ignored for VSAM data sets and SMS non-VSAM data sets. 


Liat Crumsées »nunretri 2 


For a volume or tracks COPY, WAIT specifies to DFDSS the length of a wait in 
seconds and the number of retries to obtain control of a volume or data set. 


numsecs 
is a number from 1 to 255 that specifies the interval, in seconds, between retries. 


numretries 
is a l- or 2-digit number that specifies the number of times an attempt to gain 
control of a volume is to be retried. 


For a data set COPY, WAIT specifies to DFDSS the length of the wait in seconds, 
and the number of passes to be made through the list of selected data sets to obtain 
control of a data set. 


numsecs 3 
is a number from | to 255 that specifies the interval, in seconds, to wait before 
attempting another pass through the entire list of selected data sets. 


numretries 
is a l- or 2-digit number that specifies the number of passes to make through the list 
of selected data sets in an attempt to obtain control of a data set. 
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WRitecheck 


The default for numsecs,numretries is (2,2), which specifies two retries at 2-second 
intervals. If you do not want to wait for a resource, specify 0 for either numsecs or 
numretries. 


For a data set COPY or logical data set DUMP, the WAIT keyword has a different 
meaning when: (1) data sets are being serialized, (2) multiple data sets are being 
processed, and (3) WAIT(0,0) is not specified. In this case, DFDSS makes multiple 
passes through the list of data sets. On each pass, DFDSS processes the data sets 
that (1) can be serialized without waiting for the resource and (2) were not processed 
before. At the end of a pass, if none of the data sets could be processed without 
waiting for a resource, then, in the next pass, at the first occurrence of a data set 
that was not processed, a WAIT is issued. That data set and the remainder of the 
list are processed if possible. 


The above procedure is repeated until all data sets are processed or the WAIT limits 
are reached. For example, if WAIT(3,10) is specified and five data sets are left to be 
processed, up to ten passes are made. On each pass, an unprocessed data set is 
waited upon for 3 seconds. Thus, only a 30-second maximum will ever be WAITed, 
not 150 (5 times 3 times 10). 


Paertechect| 
RC 


specifies that the data copied is to be verified for successful completion. This 
keyword increases the overall elapsed time. The default is no WRITECHECK. On 
a data set COPY in which a utility performs the copy, DFDSS ignores this keyword. 


Examples of Full and Tracks COPY Operations 
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Example 1: 


//30B1 JOB accounting information, REGION=nnnnk 

//STEPL EXEC PGM=ADRDSSU 

//SYSPRINT DD SYSOUT=A 

//DASO1 DD UNIT=3380, VOL=(PRIVATE, SER=111111) ,DISP=OLD 
//DASD2 DD UNIT=3380, VOL=(PRIVATE, SER=222222) ,DISP=OLD 
//SYSIN DD * 

command input (see Examples 1A and 1B below) 

* 


/ 


Example 1A: A Full COPY 


COPY INDDNAME(DASD1) OUTDDNAME(DASD2) - 
ALLDATA(*) ALLEXCP CANCELERROR WAIT(30,20) 


Example 1B: A Tracks COPY 


COPY TRACKS(1,0,1,15) INDDNAME(DASD1) - 
QUTDDNAME (DASD2) CANCELERROR WAIT (30,20) 


The data from DASD volume 111111 is to be copied to DASD volume 222222. For 
the full COPY, all allocated space in SAM and PAM data sets and data sets with 
null DSORG field is copied (ALLDATA(*)), when the DSILSTAR field in the 
Format 1 DSCB is nonzero. For these data sets, DFDSS copies all allocated space 
(ALLEXCP) when the DSILSTAR field in the Format | DSCB in the VTOC is 
zero. The COPY operation is to be ended if a permanent read error occurs 
(CANCELERROR). Retry 20 times at 30-second intervals (30,20) if the input or 
output volume is busy. 
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Example 2: A Tracks COPY With Track Relocation 


//30B2 JOB accounting information, REGION=nnnnk 

//STEP1 EXEC PGM=ADRDSSU 

//SYSPRINT DD SYSOUT=A 

//SYSIN DD 6C* 

COPY TRACKS(1,0,1,14) /* SOURCE TRACKS */ - 
OUTTRACKS (3,0) /* TARGET TRACKS */ - 
INDYNAM(338000) /* ALLOC VOL 338000 DYNAMICALLY */ - 
QUTDYNAM(338001) /* ALLOC VOL 338001 DYNAMICALLY */ - 
CANCELERROR /* STOP ON INPUT ERROR */ - 
WRITECHECK /* VERIFY DATA WRITTEN TO OUT VOL */ 


/* 


This example shows a tracks COPY operation in which the contents of cylinder 1, 
tracks 0 through 14, on source volume 338000 are copied to cylinder 3, tracks 0 
through 14, on target volume 338001. The operation stops if a permanent error 
occurs on the source volume (CANCELERROR). The data written to the target 
volume is to be verified (WRITECHECK). 


Examples of Data Set COPY Operations 
Example 1: A Data Set Move—Only Single Volume Data Sets 


//30B3 JOB accounting information, REGION=nnnnk 

//STEP1 EXEC PGM=ADRDSSU 

//SYSPRINT DD SYSOUT=A 

//SYSIN oD * 

COPY DATASET( - 
INCLUDE(USER1.**) /* FILTER ON DS W/1ST LEV Q USER1 */ - 
BY (MULTI,=,NO)) /* FILTER ON SINGLE VOLUME */ - 
INDYNAM (338000) /* ALLOC VOL 338000 DYNAMICALLY */ - 
OUTDYNAM(338001) /* ALLOC VOL 338001 DYNAMICALLY */ - 
DELETE 

/* 


This example shows a data set COPY in which all single-volume data sets with the 
first-level qualifier USER1 on the source volume labeled 338000 are copied to the 
target volume labeled 338001. All source data sets that are selected are deleted. The 
copied non-VSAM data sets are not cataloged. 


Example 2: A Data Set COPY to Move Data Sets to a Single Volume—Device Con- 
version 


//J30B4 JOB accounting information, REGION=nnnnk 

//STEP1 EXEC PGM=ADRDSSU 

//SYSPRINT DD SYSOUT=A 

//SYSIN OD * 

COPY DATASET ( - 
INCLUDE(USER1.**)) /* FILTER ON DS W/1ST LEV Q USER1 */ - 
OUTDYNAM (338001) /* ALLOC VOL 338001 DYNAMICALLY */ - 
DELETE CATALOG FORCE - 
TGTALLOC (SOURCE) 

/* 


This example shows a data set COPY in which all cataloged data sets with a first- 
level qualifier of USER1 (USER1.**) data sets are to be consolidated on a single 
target volume labeled 338001. The data sets are scattered on multiple source 
volumes. The target volume can be of unlike device type to any of the volumes on 
which the source data sets reside. A few of the data sets might already be on volume 
338001. The data sets are to be cataloged (CATALOG) either in the master catalog 
or in a user catalog that is pointed to by the master catalog. The source data sets 
are scratched and uncataloged (DELETE) after successfully moving them to volume 


Chapter 3. Syntax—Function Commands 51 


COPY Command 


52 DFDSS: Reference 


338001, where they will have the same allocation type (BLK, TRK, or CYL) that 
they had on the source volumes. FORCE is specified to include unmovable data 
sets. 


Example 3: A Data Set COPY of a Multivolume Data Set 


//30B5 JOB accounting information,REGION=nnnnk 

//STEP1 EXEC PGM=ADRDSSU 
//IVOL1 DD UNIT=(SYSDA,2) ,VOL=SER=(VOL111,VOL222) ,DISP=SHR 
//IVOL2 DD UNIT=SYSDA, VOL=SER=VOL222 , DISP=SHR 
//SYSPRINT DD SYSOUT=A 

//SYSIN DD 6©* 

COPY DATASET ( - 

INC(USER.MULTI.VOLUME1)) /* SELECT THIS DATA SET */ - 


INDD(IVOL1, IVOL2) /* IDENTIFY INPUT VOLUMES */ - 
OUTDYNAM( (338001) , (338002) , (338003) ) /* DYNAM ALLOC VOLS */ - 
PCTU(80,80,80) /* PERCENTUTIL = 80 PERCENT */ - 
RECATALOG(USERCAT2) 


/* 


This example shows a data set COPY in which a multivolume data set is copied to a 
set of target volumes labeled 338001, 338002, and 338003. The source data set is not 
deleted. The copied data set is cataloged in a new catalog, USERCAT2. The data 
set currently exists on multiple source volumes. Multiple output volumes are speci- 
fied for overflow purposes. These target volumes may already have some data sets 
on them. Some space is left on these volumes to allow expansion of the data sets 
(PCTU) remaining on the volumes. 


Change this example as shown below to include ALLMULTI processing on missing 
volumes. The INCLUDE keyword is changed to select all data sets on input 
volumes VOLI11 and VOL222. ALLMULTI specifies that a cataloged data set 
residing on volumes VOLI11, VOL444, and VOLSS55 will be copied even though 
VOL444 and VOLSSS are omitted from the LOGINDD volume list. 


COPY DATASET( . 
INC(**) ) /* SELECT ALL DATA: SETS */ - 
LOGINDD(IVOL1, IVOL2) /* IDENTIFY INPUT VOLUMES */ - 
OUTDYNAM( (338001) , (338002) , (338003)) /* DYNAM ALLOC VOLS */ - 


ALLMULTI /* PROCESS MISSING VOLUMES */ - 
PCTU(80,80,80) /* PERCENTUTIL = 80 PERCENT */ - 
RECATALOG(USERCAT2) 


Example 4: A Data Set COPY With DELETE and RENAMEU Options 


//J0B6 JOB accounting information, REGION=nnnnk 

//STEPL EXEC PGM=ADRDSSU 

//SYSPRINT DD SYSOQUT=A 

//SYSIN ODD * 

COPY DATASET ( - 
INCLUDE(USER1.**)) /* FILTER ON DS W/1ST LEV Q USERL */ - 
QUTDYNAM( (338001) , (338002) , (338003)) /* DYNAM ALLOC VOLS */ - 
DELETE - 
RENAMEU (USER2) - 
RECATALOG(USERCAT2) 

/* 


This example shows a data set COPY in which all data sets with the first-level qual- 
ifier USERI1 that are in the master catalog are copied to the target volumes labeled 
338001, 338002, and 338003. The copied data sets are renamed (RENAMEV) with 
the first-level qualifier USER2, followed by the second through last qualifiers of the 
old names. If data sets with the same name as the new names are on the target 
volumes or if they are already cataloged in USERCAT2, they are not copied. The 
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copied data sets are deleted (DELETE) from the source volumes, uncataloged, and 
cataloged (RECATALOG) in the catalog USERCAT2. This provides movement of 
data sets from one set of volumes to another set of volumes, from one catalog to 
another catalog, and the renaming of the data sets. 


Example 5: A Data Set COPY With REBLOCK Option 


//30B7 JOB accounting information, REGION=nnnnk 

//STEPL EXEC PGM=ADRDSSU, PARM='UTILMSG=YES' 

//SYSPRINT DD SYSOUT=A 

//DISK DD UNIT=3350,VOL=(PRIVATE,,,,SER=335001) ,DISP=SHR 
//DISK2 DD UNIT=3380,VOL=(PRIVATE,,, , SER=338001) ,DISP=SHR 
//SYSIN DD GC* 

COPY DATASET ( - 


INCLUDE (**) ) /* INCLUDE ALL DATA SETS */ - 
INDDNAME (DISK) /* INPUT VOLUME *f - 
OUTDDNAME (DISK2) /* OUTPUT VOLUME at 


REBLOCK(**.USER1.**) 
/* 


This example shows a data set COPY in which all data sets on the 3350 source 
volume labeled 335001 are copied to the 3380 target volume labeled 338001. If data 
sets with the same name are on the target volume, they are not copied. The SAM 
and PAM data sets that meet the filtering criteria specified in the REBLOCK 
keyword are reblocked on the target volume. The block size is selected by DFDSS, 
unless it is modified by the user reblock exit routine. 


Example 6: A Data Set COPY to a Preallocated Target Data Set 


//3OBn JOB accounting information, REGION=nnnnk 
//STEPL EXEC PGM=ADRDSSU 
//STEPCAT DD DSN=USERCAT,DISP=SHR 
//SYSPRINT DD  SYSOQUT=A 
//DASD1 DD UNIT=3380,VOL=(PRIVATE, SER=111111) ,DISP=OLD 
//DASD2 DD UNIT=3380,VOL=(PRIVATE, SER=222222) ,DISP=OLD 
//SYSIN Ob. -* 
COPY DATASET ( - 
INCLUDE(USER.TEST.DATA) ) - 
INDDNAME(DASD1)  - 
OUTDDNAME(DASD2) - 
REPLACE - 
DELETE 
/* 


This example shows a data set COPY in which a source data set 
(USER.TEST.DATA) allocated on volume 111111 and cataloged in catalog 
USERCAT is copied to a preallocated target data set (with the same name as the 
source) on volume 222222. The REPLACE keyword specifies that DFDSS is to 
search the target volume for a usable preallocated data set. The copied data set is 
deleted (DELETE) from the source volume. 
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' Example 7: Using COPY to Convert to SMS 


//SYSPRINT DD SYSOUT=* 
//SYSIN DDB 6* 
COPY - 
DS(INC(**)) - 
LOGINDYNAM ( - 
(338001) - 
(338002) - 


STORCLAS(DB2PERF) - 
MGMTCLAS(DBBACKUP) - 
BYPASSACS(**) - 
DELETE 

/* 


In the first step of this example, all of the data sets on the non-SMS volumes 338001 
and 338002 are copied to SMS volumes on the system. DELETE is used to avoid 
duplicate catalog entries. The ACS routines will not be invoked for this COPY. 
The storage and management classes are provided by the users using the 
STORCLAS and MGMTCLAS keywords. In addition, BYPASSACS(**) is speci- 
fied in order to suppress calls made to the ACS routines. All data sets that are sup- 
ported by SMS will be given the new storage and management classes. All data sets 
that cannot be SMS managed (for example, ISAM) will not be copied. 


//SYSPRINT DD  SYSOUT=* 
//SYSIN DD * 
COPY - 
DS(INC(**))  - 
LOGINDYNAM ( - 
(338001) - 
(338002) - 


RENUNC (AUGO387 ) 
/* 


In this next step all data sets on the non-SMS volumes 338001 and 338002 are 
copied to SMS volumes on the system. RENUNC is used to avoid duplicate catalog 
entries. The ACS routines will select a target storage and management class for each 
data set. Those data sets that cannot be SMS managed (storage class ACS routine 
returns a null storage class) will not be copied because no output volume is specified. 
Each data set that is copied will be given a new high-level qualifier (AUG0387) and 
automatically cataloged. 
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Example 8: A Data Set Copy Using CONVERT PDSE 


//SYSPRINT DD SYSOUT=* 
//SYSIN oD * 
COPY - 
DS(INC(USER.**))  - 
LOGINDYNAM ( - 
(338001) - 
(338002) - 


CONVERT (PDSE(**)) - 
RENUNC (USER.PDS.**, USER.PDSE.**) 


/* 


In this step all data sets on non-SMS volumes 338001 and 338002 are copied to SMS 
volumes on the system. CONVERT PDSE is used to convert data sets to PDSE. 
RENUNC is used to avoid duplicate catalog entries. The ACS routines will select a 
target storage and management class for each data set. Each data set that is copied 
and converted will be given a new secondary qualifier (PDSE) and automatically cat- 
aloged. 
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In Figure 4, read each column from top to bottom, reading vertically down the list 
of criteria, to discern the action taken by DFDSS. 


Codon caren ea orie sce -aa: eect eres 
Neeov anne’ (Veet ett ttt tT tt 


Empty data sets 
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Figure 4. Results of Copying Non-VSAM Data Sets 















Legend to Figure 4: 
Y Yes — 

N No 
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COPYDUMP Command 


With the COPYDUMP command, you can make from | to 255 copies of 
DFDSS-produced dump data. The data to be copied, a sequential data set, can be 
on a tape or a DASD volume, and copies can be written to a tape or a DASD 
volume. If the dump data is produced from multiple DASD volumes by using a 
data set DUMP, you can selectively copy the data from one or more of those 
volumes. 


Extra dump tapes can be used for such things as disaster recovery backup or distrib- 
ution of dumped data (for example, a newly generated system). 


COPYDUMP Command Syntax 


COPY Dum INDDnam (ddn) UTDDnam i ore 





LOGicalvol pee ee 


LVOL 


Explanation of COPYDUMP Command Keywords 
INDDname 





INDOname—— (ddn) 
‘pp. 


ddn 
specifies the name of the DD statement that identifies the sequential data set to be 
copied. This data set can reside on one or more tapes, or on DASD volume(s). 


LOGicalvolume 





setntme—]—tpote 
volser 

specifies the source DASD volume serial number from which dumped data is to be 
copied. Omission of the LOGICALVOLUME keyword causes DFDSS to copy data 
from all logical volumes in the dump data set. This keyword is useful only if the 
data being copied was created by a physical data set DUMP operation from multiple 
DASD volumes. When copying a logical dump, LOGICALVOLUME is ignored. 


OUTDDname 





seas 


0D 


ddn 
specifies the name of the DD statement that identifies the output sequential data set. 
This data set can be on a tape or a DASD volume. 
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Example 1: Making Two Copies of a Dump 


//J0B1 JOB accounting information,REGION=nnnnk 
//STEPI EXEC PGM=ADRDSSU 

//SYSPRINT DD SYSOUT=A 

//BACKUP OD UNIT=3480 , VOL=SER=TAPEO5 ,DISP=OLD, 


// DSNAME=V111111.BACKUP 

//COPY1 DD UNIT=3480, VOL=SER=TAPEO6, 

// DISP=(NEW,CATLG) ,DSNAME=V111111.BACKUP1 
//COPY2 DD UNIT=3480, VOL=SER=TAPEO7, 

// DISP=(NEW,CATLG) ,DSNAME=V111111.BACKUP2 


//SYSIN DD * 
COPYDUMP INDD(BACKUP) - 
OUTDD(COPY1,COPY2) 
/* 


In this example, two copies are to be made from a DFDSS dump tape 
(OUTDD(COPY1,COPY2)). 


Example 2: Copying a Dump Created by Using Physical Data Set Processing 


//30B2 JOB accounting information,REGION=nnnnK 
//STEPL EXEC PGM=ADRDSSU 

//SYSPRINT DD SYSOUT=A 

//TAPE2 DD UNIT=3480,VOL=SER=TAPE20, 


// LABEL=(1,SL) ,DISP=(OLD, KEEP) ,DSN=USER.BACKUP.REL3A 

//O0UTT2 DD UNIT=3480,VOL=SER=TAPE21, 

// LABEL=(1,SL) ,DISP=(NEW,CATLG) ,DSN=USER.BACKUP.REL3A.A 

//SYSIN DD * 

COPYDUMP - 
INDD (TAPE2) /* DUMP TAPE TO BE COPIED */ - 
OUTDD (OUTT2) /* NEW DUMP TAPE */ - 
LVOL (338001) /* SER NO OF VOL TO BE COPIED */ 

{* 


Assume that a physical data set DUMP was used to create a dump tape, volume 
TAPE20. Also assume that source DASD volumes 338000, 338001, and so on were 
specified, resulting in VTOCs being used for data set selection. Only the dump data 
from DASD volume 338001 is to be copied (LVOL(338001)). 


Example 3: Copying a Dump Created by Using Logical Data Set Processing 


//30B3 JOB accounting information,REGION=nnnnk 
//STEPL EXEC PGM=ADRDSSU 

//SYSPRINT DD SYSOUT=A 

//TAPE3 DD UNIT=3480,VOL=SER=TAPE30, 


fi LABEL=(1,SL) ,DISP=(OLD, KEEP) ,DSN=USER.BACKUP.REL3B 
//OUTT3 DD UNIT=3480, VOL=SER=TAPE31, 
/f LABEL=(1,SL) ,DISP=(NEW,CATLG) ,DSN=USER.BACKUP.REL3B.A 
//SYSIN DD 6C* 
COPYDUMP - 
INDD(TAPE3) /* DUMP TAPE TO BE COPIED */ - 
QUTDD(OUTT3) /* NEW DUMP TAPE */ 
/* 


Assume that a logical data set DUMP was used to create a dump tape, volume 
TAPE30. All dump data is copied. 
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With the DEFRAG command, you can relocate data set extents on a DASD volume 
(including IBM 3330 virtual volumes) to reduce or eliminate free-space fragmenta- 
tion, and print a report about free space and other volume statistics. Also, you can 
specify which data sets, if any, are to be excluded from data-set-extent relocation. 


DEFRAG Command Syntax 


a 
YNAM—((volse 


ae CG 
,unit 













soins aaitetl 
(DDName (ddn) ) 





FRAGnentati onindex7-(n) 
FRAGI 


dd 
= 
sn 





EXC] ae i 
(DDName(ddn)) 
Lasimavetn) PASswor ( 
sce 











AIT(numsecs ,numretries) 


Explanation of DEFRAG Command Keywords 


BY(DDName) 


BY(LISt) 





BY—(DDName (ddn)) 
specifies data set filtering criteria. 


ddn 

specifies the name of the DD statement that identifies a sequential data set or 
member of a partitioned data set that contains the filtering criteria to use. This is in 
the form of card-image records, in DFDSS command syntax, that contain the BY 
keywords described below. 


ee a 


specifies data set filtering. To select the data set for inclusion in the DEFRAG oper- 
ation, a/] BY criteria must be met. See “Filtering by Data Set Characteristics” on 
page 12 for further information on BY filtering. 





BY 
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DDName 


DYNALIoc 


DYNAM 


EXClude 
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-=-0Nane (dd) 


ddn 
specifies the name of the DD statement that describes the volume to be processed. 


Loynattoc-! 


specifies dynamic allocation, instead of enqueue, to serialize the use of data sets. 
The data sets whose extents are to be relocated are serialized throughout DEFRAG. 
This allows cross-system serialization in a JES3/MVS environment. 


Consider: 


e The serialization is of value only when the dynamic allocation/JES3 interface is 
not disabled. 


e SVC 99 is used to serialize data sets. 


e Run time increases when you use DYNALLOC to serialize data sets (as opposed 
to enqueue) because overhead is involved in dynamic allocation and serialization 
across multiple processors. 


¢ Using INDYNAM instead of DD statements to allocate DASD volumes does 
not appreciably increase run time and permits easier coding of JCL and 
command input. 


em vol ane 
,unit 


specifies that the volume to be processed is to be dynamically allocated. If the 
volume is real (not virtual), it must be mounted and online. 


volser 
specifies the volume serial number of a DASD volume to be processed. 


unit 
specifies the device type of a DASD volume to be processed. This keyword is 
optional. 





(LISt( a 


EXE IMee 7 
(DDName ( a 


dsn 

specifies a fully- or partially-qualified name of a data set to be excluded from the 
DEFRAG operation. You can specify either a cluster or component name for 
VSAM data sets. 


ddn 
specifies the name of the DD statement that identifies a sequential data set or 
member of a partitioned data set. 


MAXmove 


PASsword 


FRAGmentationindex 


DEFRAG Command 


L Feacnentati oni naex—(n) J 
FRAGI 


specifies that DEFRAG is to end if the fragmentation index is less than n, where n is 
a l- to 3-digit number. DFDSS prefixes your number, n, with a decimal point. For 
example, / becomes .J, 999 becomes .999, 001 becomes .001, and so forth. For more 
information, see Data Facility Data Set Services: User’s Guide. 


Lvaxmove (n)— 


n 
is a l- to 4-digit number that specifies that DFDSS is to attempt to assemble up ton 
tracks in a contiguous free area. If DEFRAG algorithms cannot assemble n contig- 
uous free tracks without moving more than n tracks, or if n contiguous free tracks 
already exist, DFDSS issues a message and ends the DEFRAG operation. If 
MAXMOVE is noi specified, DFDSS tries to assemble a contiguous free area of a 
size equa! to the total number of free tracks on the volume. 


The first pass attempts to assemble the largest contiguous amount of free space with 
a minimum amount of data movement. If you want the DEFRAG operation to end 


The second pass attempis to assemble multiple groups of large areas of contiguous 
free space and generally moves more data around than the first pass. This technique 
usually refines the results of the first pass, but might result in a situation in which 
the largest individual free space is smaller than existed on the DASD originally or 
after the first pass. 





serene 
—catname | | 
a a “LipswdH 


Taser 





specifies zhe passwords DFDSS is to use for password-protected data sets. (Pass- 
word checking is bypassed for RACF-protected data sets.) This must be specified 
only if: 

¢ You do not have the required RACF DASDVOL or RACF DATASET access. 

¢ The installation authorization exit does not bypass the checks. 

« You do not want to be prompted for the password. 


For VSAM data sets. password checking ts done only at the cluster level. 


ddn 

specifies -he name or the DD statement that identifies the sequential data set, or 
member of a partitioned data set that contains data set names and their passwords. 
This data set must contain card-image records in DFDSS command syntax format. 


dsn/[pswd 
dsn is a fully-qualified data set name. psid is its password. If no password follows 
the slash ( ). dsn is treated as though it were ddan. 


Printing of actual data set passwords specified in the input command stream is sup- 
pressed in the SYSPRINT output. 
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~ DEFRAG Command | 


WAIT 


Laptitsnesece Heretics) 


specifies to DFDSS the length of a wait in seconds and the number of retries to 
obtain control of a volume or data set. 


numsecs 
is a number from 1 to 255 that specifies the interval, in seconds, between retries. 


numretries 
is a l- or 2-digit number that specifies the number of times an attempt to gain 
control of a volume or data set is to be retried. 


The default for numsecs,numretries is (2,2), which specifies two retries at 2-second 
intervals. If you do not want to wait for a resource, specify 0 for either numsecs or 
numretries. 


Examples of DEFRAG Operations 
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Example 1: A DEFRAG With Excluded Data Sets 


//30B1 JOB accounting information,REGION=nnnnkK | 
//STEPL EXEC PGM=ADRDSSU 

//SYSPRINT OD SYSOUT=A 

//DASD DD UNIT=3380, VOL=(PRIVATE,SER=111111) ,DISP=0OLD 
//AL DD §DSN=USER2.EXCLUDE,DISP=SHR ni: 
//SYSIN DO x 

command input (see examples 1A and 1B below) 

*& 


/ 


Example 1A: With the Names of Excluded Data Sets in the Input Stream 


DEFRAG ODDNAME(DASD) - 
EXCLUDE (LIST(USER2.**.LIST,*. LOAD) ) 


Example 1B: With the Names of Excluded Data Sets in a Data Set 


DEFRAG DDNAME(DASD) - 
EXCLUDE (DDNAME (A1) ) 


In examples 1A and 1B, DASD volume 111111 is defragmented. All data sets whose 
first and last qualifiers are USER2 and LIST, respectively, are to be excluded from 
this operation, as are data sets with two qualifiers whose second qualifier is LOAD. 
In example 1B, cataloged data set USER2.EXCLUDE contains a single card-image 
record with the following in columns 2 through 72: 


USER2, **.LIST,*. LOAD 


Example 2: A DEFRAG Using a BY Criterion 


//30B2 JOB accounting information,REGION=nnnnk 

//STEP1 EXEC PGM=ADRDSSU 

//SYSPRINT DO  SYSOUT=A 

//DASD DD UNIT=3380,VOL=(PRIVATE,SER=111111) ,DISP=0LD 

//SYSIN DD =6* 

DEFRAG DDNAME(DASD) /* VOLUME TO BE PROCESSED */ - 
BY(LIST(REFDT LT *,-1)) /* DATE LAST REF LT RUN DATE -1 */ 

/* 


Only data sets last referenced more than one day before the run date are included in 
this DEFRAG operation. That is, those that were last referenced one day before or 
on the run date are excluded. 


ah lecetgs 2 ecko 


Results of a Successful DEFRAG Operation 


DEFRAG Command — 
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Figure 5 on page 63 is the printout from a DEFRAG run for a DASD volume. It 
gives an indication of the free space fragmentation before and after a DEFRAG 
operation, as well as the distribution of data set extents by size. 


The following JCL was used for this job: 


//SAMPLE1 JOB accounting information,REGION=nnnnk 
//STEP4 EXEC PGM=ADRDSSU 
//SYSPRINT DD SYSOUT=* 
//DASOL DD VOL=SER=DUMPDS , UNIT=3380,DISP=0LD 
//SYSIN DD * 

DEFRAG DDNAME (DASD1) 
ft 






PAGE QQ01 DFDSS 5665-327 DATA FACILITY DATA SET SERVICES V2R5.0 89.067 14:55 






DEFRAG DONAME (DASD1) 150000 
ADR1011 RIQ1 (01), TASKID 001 HAS BEEN ASSIGNED TO COMMAND 'DEFRAG ' 
ADR1091 RIO1 (01), 89067 14:55:32 INITIAL SCAN OF USER CONTROL STATEMENTS COMPLETED. 






ADROO6I (001)-SETUP(01), 89067 14:55:32 PROCESSING BEGINS 
ADR2081 (Q01)-DANAL(01), BEGINNING STATISTICS ON DUMPDS: 






















FREE CYLINDERS 0027 

FREE TRACKS 0021 

FREE EXTENTS 0004 

LARGEST FREE EXTENT (CYL,TRK) 0027,0000 

FRAGMENTATION INDEX 0.046 

, PERCENT FREE SPACE — _? 23 

ADR2131 (001)-DANAL(Q1), ENDING STATISTICS ON DUMPDS: 

DATA SET EXTENTS RELOCATED 0002 

TRACKS RELOCATED 9004 

FREE CYLINDERS 9027 

FREE TRACKS 0021 

FREE EXTENTS 0002 

LARGEST FREE EXTENT (CYL,TRK}  0026,9011 
FRAGMENTATION INDEX 9,044 


PAGE 9002 DFDSS 5665-327 DATA FACILITY DATA SET SERVICES V2R5.0 89.067 14:55 
ADR2121 (001)-DANAL(Q1), EXTENT DISTRIBUTION MAP FOR DUMPDS: 
EXTENT ** INPUT FREE** **QUTPUT FREE** ** OCCUPIED ** 


| SIZE 
| IN NO. CUM. NO. CUM, NO. CUM, 
TRACKS EXTS PCT/100 EXTS PCT/100 EXTS PCT/100 
1 0.000 9.000 19 0.007 
2 1 9.004 9.000 6 0.016 
3 1 0.011 0.000 1 0.018 
4 0.011 0.000 1 9.021 
10 9.011 9.000 1 9,028 
15 0.011 0.000 4 0.072 
16 1 9.049 0.000 0.072 
25 0.049 1 0.058 0.072 
20 0.049 9.058 4 2G. 437 
75 0.049 0.058 3 0.301 
105 0.049 9.058 2 0,454 
375 9.049 9.058 2 1.000 
| 401 0.049 1 1,000 1.000 
| 405 1 1.000 1.000 1.000 


ADROI31 (001)-CLTSK(Q1), 89067 14:55:44 TASK COMPLETED wiTH RETURN CODE 0000 
ADRO121 DSSU (01), 89067 14:55: . DFDSS PROCESSING COMPLETE. HIGHEST RETURN CODE IS 9000 








Figure 5. Printed Output Resulting from a Successful DEFRAG Run 


The value in the first column of message ADR2121 is the size of the extent in tracks 
(free space or data set) and is printed only if an extent of that size occurs. The 
second and third columns show the number of free space extents existing before 
processing that were of the size shown in the first column, along with their cumula- 
tive percentage divided by 100. The fourth and fifth columns give the same informa- 
tion for free space, but after processing. The sixth and seventh columns give the 
distribution of occupied data set extents, which do not change during a run. 
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DUMP Command © a ee 
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DUMP Command 


With the DUMP command, you can dump DASD data to a sequential data set. 
The storage medium for the sequential data set can be a tape, DASD, or a mass 
storage virtual volume. You can dump data sets, an entire volume, or ranges of 
tracks. 


Note: The FULL keyword for the DUMP command specifies that an entire DASD © 
volume is to be dumped. The TRACKS keyword for DUMP specifies ranges of 
tracks to be dumped. 


DFDSS offers two ways to process DUMP commands: 


¢ Logical processing is data-set oriented, which means it operates against data sets 
and volumes independently of physical device format. 


¢ Physical processing can operate against data sets, volumes, and tracks, but is ori- 
ented toward moving data at the track-image level. 


The processing method is determined by the keywords specified on the command. 


DFDSS logical DUMP processing cannot be used to process partitioned data sets 
containing location-dependent information that does not reside in note lists or in the 
directory. For example, PDS toad libraries that contain overlay moc: are > not 
supported during logical DUMP processing. 


For information on using the DUMP command, see Data Facility Data Set Services: 
User’s Guide. 


DUMP Command Syntax for FULL or TRACKS 
POU oan Seen ele sea ee ee a ee 
es | 
oe eee 


I 


Tesréer —- oe 








»>—-——INDDname 


(ddn) OUTDOname ee 
i | 5 caaniell 


TNDYnam-———- (vol ser \H 
Lipy nit 
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“= DUMP Comimand’”’ 


Optional Keywords ri with FULL 


‘] ALLExc ANcelerro 


[ ALLX 
L—Ai _cata-(ydsn+) 
Rese ae a 





COMpress OPTimize(n) 


PASsword—7—( ddn ) 
reAssvorep 
catname | 
| L-/psne 
dsn 


RESE:~ TOLerate—(-IOERror—) 








WAIT (numsecs ,numretries) 


| ‘ ae | | 
| -rnceover 1 ow ‘laels 


Optional Keywords ri with TRACKS 





: 
ior 


—CANc2° ervor— “-CoMprass— “-OPTini ze(n)— 





L eoiesdee=(—foedoe j= 


| a | _wAIT(numsacs ,numretries)— 
: etc 
“p72 +2KOverfl ow (dsm) 
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-. DUIVLP. Command 


ey Qe A ed te eet at and RS Se ae 


Loaiéal Data Set | DUMP Command atsiniaz 


prey Se 7 | a or 


FILterdd—7—(ddn) 
FoD-——|_ 





ee eee 


Additional ead with DATASet 
CE 


‘demerit 


eee | | fe | 
BY(y(schar,op, (yarg~)—) 


vic. El —schar,op, \ co 


EXC] eel 















EXC] ude—( len 
a. 





| schar,op, Cl a 





toa 


Optional Logical aa DUMP Keywords 


aoe ALLMul ti 
| | | 
INCAT (ycatname+) 


~~ 









} 
t 
| 


erates tae 


| C10 


| | 
i LOGINDYnam——( MONO. a) 


i) 
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Physical Data Set DUMP Command ecaag 
st a Sls fa )——_—_____-> 


FILterdd——(ddn) 
roo 


oo a 
oe feted Gea 


IDY ,unit 





a Db lati ae 
D 


Additional oe os with DATASet 


INClude—(ydsn-) 


mere fe 















ac FI schar,op, ( [_ i ) 
veo. Ei schar,op, ( cal 


! 
oe: . aie 


Pee 
ee 


eo I (schar,o eal 
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DUMP Command 


firs A aye 
= Segves cuts ere ae : 


Optional Keywords a Logical and Physical Data Set DUMP 
F 





Pee 


ALLData-(*) 





COMpress DELete DYNALT oc OPTimize(n) 


PASsword——( ddn pa LPurse-| 
pswD—— PR 
| catnam 
Lipswe 
dsn 


— Lresetd ~ Estare . . 
SHR 


TOLerate—(—7—-I0ERro ) eee tS 
ENQFai lure 
ENQFaitur 
IOERro 








UNCATa‘cc— “WAIT(numsecs,numretries) 





 agtececaisis 
Explanation of DUMP Command Keywords 
ALLData 











| , 
Le aiieac lial 


ALLData-{*) 
applies to full and data set DUMP operations. 
dsn 


specifies the name of a SAM (DSORG=P%S or PSU) or PAM (DSORG=PO or 
POU) data set or a data set with a null DSORG field for which all allocated space is 


to be dumped.é 
specifies that all allocated space is to be dumped for: 
¢ allSAM and PAM data sets 


and 


6 A data set can have data beyond the limits des. ribed by the DSCB DSILSTAR field or it can contain a null 
DSILSTAR field. For example, JES2.JES3 data sets can have these characteristics, as can CICS journal and 


MSVCJRNL data sets. 
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ALLExcp 


ALLMulti 


BY 


CANcelerror 


- DUMP. Comma: 


e data sets with a null DSORG field that are selected in the DUMP operation and 
whose DSILSTAR field is nonzero. 


The DSILSTAR field contains the last-used track and last block on that track in 
the form of a TTR. 


Latexce—] = Sed : 
ALLX 


is an option for full and data set DUMP operations. It instructs DFDSS to dump 
all space allocated for data sets whose DSCB DSILSTAR field is zero. This 
includes SAM and PAM data sets, and data sets with a null DSORG field.¢6 


Larwuiti 


specifies that cataloged, multivolume data sets residing on volumes missing from the 
LOGINDDNAME or LOGINDYNAM volume list are to be dumped in their 
entirety. To qualify for ALLMULTI processing, a data set must be cataloged and 
have at least one primary volume specified in the LOGINDDNAME or 
LOGINDYNAM list. Data from the missing volume(s) will be dumped for appli- 
cable data sets. 


Note: The ALLMULTI keyword is valid only when it is specified in conjunction 
with LOGINDDNAME or LOGINDYNAM. 


oval 
>-3Y(y(-so-ar,op, (yarg+)+ pales ee ee 
bisetl ot lama 


pore mea —EXClude(gdsn 





specifies that the data sets selected up to this point by the processing of the 
INCLUDE and EXCLUDE keywords are to be further filtered. To select the data 
set, all BY criteria must be met. See the separate discussions of INCLUDE and 
EXCLUDE for information on how these keywords are specified. 


Note: A data set is considered not cataloged if it is not cataloged in the standard 


order of search or if the catalog that the data set is cataloged in is not available. 


loancs” Schon 


specifies that the DUMP is to be ended if a track-related permanent read error 
occurs. If this keyword is nor specified and a permanent read error occurs, the track 
image record is flagged on the output volume as having an I/O error, and the 
DUMP continues. This track is cleared in a RESTORE operation. When 
CANCELERROR is specified, TOLERATE(IOERROR) is ignored. 


Note: CANCELERROR has no effect on the following types of errors on a DASD 
volume: 


Equipment check 
Command reject 
Intervention required 
Busout parity. 
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DUMP Command} 


COMpress 


DATASet 


compress 


specifies that the dumped data is to be written in compressed form to the output 
medium. This decreases the space occupied by the dump data at the expense of 
increased processor and elapsed times. 


Notes: 


1. The DFDSS stand-alone restore program can restore any physical dump made 
by DFDSS as long as the physical dump is the first data set on the tape volume. 
The dump tapes may contain standard user labels. 


2. If you have a tape drive with the compaction feature and you want to use hard- 
ware data compaction, you do not need to specify the COMPRESS keyword If 
software data compression is desired, you do not need to specify 
DCB=TRTCH=COMP in the JCL. 


ee 
DS: ; . : oh : : : : 


specifies a data set DUMP operation, using filtering. See Chapter 2, “Choosing the 
Data Sets You Want Processed—Filtering” on page 9 for an explanation of the fil- 


-. tering process used. Unless you use DATASET along with ALLDATA or © 


DELete 
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ALLEXCP, only used tracks are dumped for SAM and PAM data sets and for data 
sets with a null DSORG field (for example, JES2/JES3 data sets). If the free space 
map in the VTOC is invalid, all tracks are dumped. 


Notes: 


1. Either the FILTERDD or the INCLUDE keyword must be substituted when 
DATASET is selected. 


2. VSAM catalogs are not supported for data set processing. If VSAM catalogs 
are processed. the results can be unpredictable. 


Loetete! 


applies to physical and logical data set DUMP. For a physical data set DUMP, 
DELETE instructs DFDSS to delete expired single-volume, non-VSAM data sets 
that are successfully serialized and dumped. In addition, DFDSS is to uncatalog 
successfully deleted data sets. DELETE is ignored for VSAM data sets. Even if 
PROCESS(SYS1) is specified, SYS!1.VVDS and SYS1.VTOCIX data sets cannot be 
dumped and deleted. 


For a logical data set DUMP. DELETE can be used to delete expired single- and 
multivolume VSAM and non-VSAM data sets. Unmovable data sets can also be 
deleted. User catalogs and VSAM alternate indexes cannot be deleted. Unexpired 
source data sets are deleted only if you also specify PURGE. 


To delete or scratch a password-protected data set, the operator must supply the 
password for DADSM scratch password checking. 


Note: Do not specify SHARE if you specify DELETE. 


DYNALIoc 


EXClude 


FiLterdd 


FULL 


“DUMP Command 


Loynat toc! 


specifies dynamic allocation, instead of enqueue, to serialize the use of data sets. 
This allows cross-system serialization in a JES3/MVS environment. 
Consider: 


¢ The serialization is of value only when the dynamic allocation/JES3 interface is | 
not disabled. 


¢ SVC 99 is used to serialize data sets. 


¢ Run time increases when you use DYNALLOC to serialize data sets (as opposed 
to enqueue) because overhead is involved in dynamic allocation and serialization 
across multiple processors. 


ssa: 







~~ 





see ll [ | | 
—3Y (¢(—schar,op, (wargt)+) 
dsn 


specifies the name of a data set to be excluded from the data sets selected by 
INCLUDE. Either a fully- or a partially-qualified data set name can be used. See 
the separate discussions of INCLUDE and BY for information on how these 
keywords are specified. 





get aia (ddn) 


specifies the name of the DD statement that identifies the sequential data set or 
member of a partitioned data set that contains the filtering criteria to use. The fil- 
tering criteria are in the form of card-image records, in DFDSS command syntax, 
containing the INCLUDE, EXCLUDE, and BY keywords that complete the DUMP 
command syntax. 


Note: You must use FILTERDD when you have more than 255 entries in the 
INCLUDE, EXCLUDE, or BY list of subkeywords. 





FULL 

FuL— 
specifies that an entire DASD volume is to be dumped. This is the default. Unallo- 
cated tracks are not dumped. Unless FULL is specified with ALLDATA or 
ALLEXCP, only used tracks are dumped for SAM and PAM data sets and for data 
sets with a null DSORG field (for example, JES2/JES3 data sets). If the free space 
map in the VTOC is invalid, all tracks are dumped. Used tracks consist of the 
tracks from the beginning of the data set to the last-used track (as indicated in the 
DSILSTAR field of the Format 1 DSCB). 
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DUMP Command 


INCAT 


INClude 


INDDname 


INDYnam 
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Notes: 
1. You cannot specify SHARE or TOL(ENQF) for FULL operations. 


2. VSAM catalogs are not supported for full volume processing. If VSAM catalogs 
are processed, the results can be unpredictable. 


Mie! 


specifies one or more user catalogs to be searched before the standard order of 
search for locating data sets. STEPCAT and JOBCAT are not allowed for proc- 
essing SMS-managed data sets. INCAT allows you to identify specific source cata- 
logs. To specify INCAT you must have the proper RACF facility class 
authorization (refer to Resource Access Control Facility (RACF) Security 
Administrator’s Guide for additional information). 


catname 
specifies a fully-qualified catalog name. 





sata | fis) | 
BY (y(schar,op, (yarg~)+) 
dsn 


specifies the name of a data set eligible to be dumped. Either a fully- or a partially- 
qualified data set name can be used. See “Filtering by Data Set Names” on 

page 10. If INCLUDE is omitted (but EXCLUDE or BY is specified) or if 
INCLUDE(**) is specified. a// data sets are eligible to be selected for dumping. See 
the separate discussions of EXCLUDE and BY for information on how these 
keywords are specified. 





INDDname nl 
1 


ddn 

specifies the name of the DD statement that identifies the input volume to be 
dumped. To assure correct processing, each of the DD statements corresponding to 
a DDNAME (ddn) must identify only one volume serial number. 


Note: Only one ddn can be specified for INDDname when you use full or tracks 
DUMP. One or more are allowed for a physical data set DUMP. 


oe ae | SESS 


Je] 
IDY junit 


specifies that volume(s) to be dumped are to be dynamically allocated for a full, 
tracks, or physical data set dump. 


LOGINDDname 


LOGINDYnam 


DUMP Command 


Notes: 
i. If the volume is real (not virtual), it must be mounted and online. 


2. Only one volume is allowed for a full or tracks DUMP; one or more volumes 
are allowed for a physical data set DUMP. 


3. Using INDYNAM instead of DD statements to allocate DASD volumes does 
not appreciably increase run time and permits easier coding of JCL and 
command input. 


volser 

specifies the volume serial number of a DASD volume to be dumped. 

unit 

specifies the device type of a DASD volume to be dumped. This keyword is 
optional. 


Notes: 


1. If either INDDNAME or INDYNAM 1s specified, physical processing is used to 
perform the dump. 


2. If both INDDNAME and INDYNAM are sii a ieeical data: set dump is 
performed. 


3. A logical data set dump is also performed if you specify LOGINDDNAME or 
LOGINDYNAM. 


Aiea eee ee 


——~LOG!NODname——(yddnt) 
i cued 


ddn 

specifies the name of the DD statement that identifies the input volume that contains 
the data set(s) for a logical dump. To ensure correct processing, each of the DD 
statements corresponding to a DDNAME (ddn) must identify only one volume serial 
number. 


TT SST 
[anew 


Logis aa (y(volser )4)- 
ig Ee 


specifies that volume(s) that contain the data set(s) to be dumped using logical proc- 
essing are to be dynamically allocated. 


Note: If the volume is real (not virtual), it must be mounted and online. 


volser 

specifies the volume serial number of a DASD volume to be dumped. 

unit 

specifies the device type of a DASD volume to be dumped. This keyword is 
optional. 
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DUMP Command 


OPTimize 


_ keyword uses more real and virtual storage. .It also keeps the channel busy for .....-. 


OUTDDname 


PASsword 
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Notes: 


1. If LOGINDDNAME or LOGINDYNAM is specified, DFDSS uses logical 
processing to perform the dump. Logical processing is also used if no input 
volume is specified. 


2. A multivolume data set that has extents on volumes not specified with 
.. . LOGINDDNAME or LOGINDYNAM will not be dumped if you omit | 
ALLMULTI. 


Loprimize(n)— 


specifies the number of tracks to be read at a time, as follows: 


If nis 1, DFDSS reads one track at a time. 

If n is 2, DFDSS reads two tracks at a time. 
If n is 3, DFDSS reads five tracks at a time. 
If n is 4, DFDSS reads one cylinder at a time. 


If OPTIMIZE is not specified, OPTIMIZE(1) is the default. OPTIMIZE(2), (3), and © 
(4) can be processed efficiently for data sets with no track overflow records. Speci- 
fying OPTIMIZE (2), (3), or (4) reduces the time for a dump. Notice that this 


longer blocks of time. 


Note: There is no performance gain on mass storage virtual volumes by specifying 
OPTIMIZE. 


- 





>———0UTDSr ane Lek 
cee 


Loop 


ddn 

specifies the name of the DD statement that identifies the (output) dump data set. 
This data set can be on a tape ora DASD volume. Up to 255 DDNAMEs can be 
specified: that is, up to 255 dump copies can be made. 


L-passnors ( ddn J 
Cesyo-——|_ 

~catname | 

. —/pswd 








—dsn 


specifies the passwords DFDSS is to use for password-protected data sets for all 
DUMP operations. (Password checking is bypassed for RACF-protected data sets.) 
This is required only if: 


¢ You do not have the required volume-level RACF DASDVOL or RACF 
DATASET access. 

¢ The installation authorization exit does not bypass the checks. 

¢ You do not want to be prompted for the password. For DFDSS authorization 
checking, see the DELETE keyword for the DUMP command. 


For VSAM data sets, password checking can be done only at the cluster level. 


| 
: 
| 


PROCESS 


PURge 


RESEt 


SHAre 


DUMP Command 


ddn 

specifies the name of the DD statement that identifies the sequential data set or 
member of a partitioned data set that contains data set names and their passwords. 
This data set must contain card-image records in DFDSS command syntax format. 


dsn|[pswd 
dsn is a fully-qualified data set name. pswd is its password. If no Speers follows 
the slash (/), dsn is treated as though it were ddn. 


catname|pswd 
catname is a fully-qualified catalog data set name. pswd is its password. This is 
supported for VSAM data sets only. 


Note: Printing of actual data set passwords specified in your input command stream 
is suppressed in the SYSPRINT output. 


eee eal 


specifies that when the DELETE keyword is also specified, DFDSS is to dump and | 
delete data sets with the high-level qualifier of SYS1. However, even if 
PROCESS(SYS1) is specified, SYS!1.VVDSs and SYS1.VTOCIXs are not processed. 
Refer to Resource Access Contre! Sac: ( Rar / Decry: Administrator’ Ss Guide for 


* - additional information. 


Puce 

PRG 

for a data set DUMP, instructs DFDSS to delete unexpired data sets that are 
dumped successfully. This keyword is valid only when DELETE has been specified. 


Lneset- 


specifies that the data-set-changed flag (DSIDSCHA field) is to be reset for all data 
sets serialized and successfully dumped. This applies to both a full DUMP and a 
data set DUMP. 


Note: Do not specify SHARE if you specify RESET. You might not want to 
specify RESET if you use a storage management program, such as the Data Facility 
Hierarchical Storage Manager (DFHSM). 


oe ee ey OR = ot, me 

—SHAre-{ 

—SHR— 
specifies that DFDSS is to share the data sets to be dumped for read access with 
other programs. Do not specify DELETE, RESET. or UNCATALOG if you 
specify SHARE. Use SHARE carefully to ensure that the contents of the dumped 
copy of the data set are valid. 


SHARE and FULL are mutually exclusive; you cannot specify these keywords 
together. 
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SPHERE 


TOLerate 


TRACKS 
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Lspuere— 


is an option for a logical data sett DUMP. SPHERE specifies that for any VSAM 
cluster dumped DFDSS must also dump all associated AIX clusters and paths. Indi- 
vidual sphere components need not be specified, only the base cluster name. 


L eieanece= IOERre cai 


1 . ENQFai lure 
ENQFailure 
IOERro 


ENQFailure 
specifies that data sets are to be processed even though shared or exclusive access 
fails. 


TOL(ENQF) and FULL are mutually exclusive; you cannot specify these keywords 
together. 


For more information on TOL(ENQF), see Appendix B, “Serialization and Authori- 
zation Checking” on page 16S. 


IOERror 


- specifies that DFDSS is to continue processing even though input errors occur, but is 


to end after 100 errors. This applies only to input errors and only to equipment 
check and busout parity. 


Notes: 
1. TOL(IOERror) is ignored if CANcelerror is specified. 


2. If a permanent read error occurs, the track image record is flagged on output as 
having an I/O error and the DUMP continues. 


3. This track is cleared in a RESTORE operation. 
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specifies ranges of tracks to be dumped. When you restore the data, this entire 
range or its subset must be specified with the RESTORE command. 


cl,Al 
specifies the cylinder and head number of the beginning of the range. Specify 
hexadecimal numbers as X'cl' or X'hl'. 


c2,h2 
specifies the cylinder and head number of the end of the range. Specify hexadecimal 
numbers as X'c2' or X'h2'. 


Notes: 
1. The c2 must be greater than or equal to cl. 


2. If c2 equals cl, h2 must be greater than or equal to hl. 


DUMP Command 


DFDSS verifies that the range is within the limits of the device. If you do not 
specify all four values for a range, DFDSS provides the missing values unless the 
omitted value causes a syntax error. No intervening values can be omitted. For 
example: 


Specified Results 


None .. Syntax error 
cl cl,0,cl,maximum head number 
cl,hAl cl,hl,cl,maximum head number 


cl,hl,c2.—cl,hl,c2,maximum head number 
cl,,c2 Syntax error 


Al Syntax error 


TRACKOverflow 





TRACKOverf 1ow—- ee 
RKC 

dsn 
-- specifies the name of data set(s) in which track overflow records are present but not® 


indicated by the Format | DSCB. The TRACKOVERFLOW keyword is not 
needed for data sets indicated as having overflow records. 


Note: When you perform a logical DUMP, the use of TRACKOVERFLOW marks 
the data set on the dump tape. This allows logica! RESTORE to correctly track- 
pack the data set if required.” The target’s Format | DSCB will be set to indicate 
overflow records are present when the data set 1s restored. If OPTIMIZE(2), (3), or 
(4) is specified, specifying TRACKOVERFLOW can result in fewer EXCPs on the 
source DASD device. 


UNCATalog 
Luneana: "5 


applies to physical and logical data set DUMP. 


For a physical data sett DUMP, UNCATALOG instructs DFDSS to uncatalog any 
single-volume, non-VSAM. cataloged data sets successfully dumped from the current 
volume. 


Note: A data set with a high-level qualifier of SYS! cannot be uncataloged. 
For a logical data set DUMP. UNCATALOG instructs DFDSS to uncatalog any 


successfully dumped single- or multivolume non-VSAM data sets that are currently 
cataloged. (For VSAM data sets, use the DELETE keyword.) 


Note: UNCATALOG 1s ignored for logical and SMS-managed data sets. 


7 Track-packing is a technique used by DFDSS to build target tracks for any DASD device by using input physical 
record information. For example, when copying a data set from a DASD with smaller track capacity to a DASD 
with larger track capacity, DF DSS reads full tracks from the source and copies the physical records from one or 
more input tracks into a single output track of the target data set. 


Chapter 3. Syntax—Function Commands 77 


DUMP Command 


WAIT 


Lawart {numsecs ,numretries \-] 


For a volume, tracks, or physical data set DUMP, WAIT specifies to DFDSS the 
length of a wait and the number of retries to obtain control of a volume or data set. 


numsecs- oo EE cielo Pata ene | a tae ee sab - fxben BS ole 
is a number from | to 255 that specifies the interval, in seconds, between retries. 
numretries 


is a l- or 2-digit number that specifies the number of times DFDSS must retry to 
gain control of a volume or data set. 


For a logical data set DUMP, WAIT specifies to DFDSS the length of wait and the 
number of passes to be made through the list of selected data sets to obtain control 
of a data set. 


numsecs 
is a number from 1 to 255 that specifies the interval, in seconds, to wait before 
attempting another pass through the list of selected data sets. 


numretries 
is a 1- or 2-digit number that specifies the number of passes to make through the list 


.. Of selected data sets in an attempt.to obtain control of.a data set... . 


The default for numsecs,numretries is (2,2), which specifies two retries at 2-second 
intervals. If you do not want to wait for a resource, specify 0 for either numsecs or 
numretries. 


For a data set COPY or logical data set DUMP, the WAIT keyword has a different 
meaning when: (1) data sets are being serialized, (2) multiple data sets are being 
processed. and (3) WAIT(0,0) is not specified. In this case, DFDSS makes multiple 
passes through the list of selected data sets. On each pass, DFDSS processes the 
data sets that (1) can be serialized without waiting for the resource and (2) were not 
processed before. At the end of a pass. if none of the data sets could be processed 
without waiting for a resource, then, in the next pass, at the first occurrence of a 
data set that was not processed, a WAIT will be issued. That data set and the 
remainder of the list will be processed if possible. The above procedure will be 
repeated until all data sets are processed or the WAIT limits are reached. For 
example. if WAIT(3,10) is specified and 5 data sets are left to be processed, up to 10 
passes are made. On each pass, an unprocessed data set is waited upon for 3 
seconds. Thus. only a 30-second maximum will ever be WAITed. not 150 (5 times 3 
times 10). 


Data Integrity Considerations for Full or Tracks DUMP 
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For a full or tracks DUMP, DFDSS serializes the VTOC to preclude DADSM func- 
tions such as ALLOCATE, EXTEND. RENAME, and SCRATCH from changing 
the contents of the VTOC on the volume during the DUMP. Data sets are not seri- 
alized on these full or tracks operations. Therefore, some data sets might be opened 
by other jobs during the DUMP. The net result might be that partially updated 
data sets are dumped. For mountable devices, you can minimize this possibility by 
doing the following: 


1. Specify PRIVATE and DEFER in the DD statement. 


2. Specify unit affinity on a second DD statement that defines a mountable device. 


TNL SN35—0375 (01 Sept 1990) to SC26-4389-1 ~- DUMP Command 


3. Specify a volume count in the VOLUME keyword of a DD statement that is 
greater than the number of mountable devices to be allocated. 
4. Take the dump when there is low system activity. 


Full data integrity can always be guaranteed by performing DUMP operations bv 
data set only. 





| Product Implementation Information 


Format of the Output Data Set 
For a physical DUMP, each logical volume of a dump data set contains data in the 
following sequence: 


1. Volume header record: identifies and contains data pertinent to the whole 
volume and identifies the type of operation that created the dump. 


2. Map record or records: maps the tracks that were dumped. 

3. Track 0: dump of track 0 of cylinder 0. 

4. VVDS track records if VSAM data sets exist on the volume and were dumped. 
5. VTOC track records. 

6. Data track records. including VVDS if it was part of the dump. Item 6 is 

_ - repeated for each data set. a ee Rie a sect 

7. Two volume trailer records: identifies the end of the data for the DASD 


volume. 


For a logical DUMP, the format of the output data set is: 


fape neader record. 

List of potential data sets record. 

. Data set header record. 

. Sphere information record (if the SPHERE kes word was specified and this data 
set is part of a sphere). 

53. Volume header record. 

. Data track record(s) (one for each track of the data set on this volume). Items 5 
and 6 are repeated for each volume of the data set. 

. Two data set trailer records. Items 3 through 7 are repeated for each data set. 


1S eee ee 


Ie 


lon 


~] 


See Appendix E, “Data Area Descriptions” on page 220 for a detailed mapping 
of the ADRBMB mapping macro and the ADRTAPB mapping macro. 


_ End of Product Implementation Information — 


Examples of Full and Tracks DUMP Operations 
In the following example. DASD volume III111 is to be dumped to the first data set 
of standard label tape volumes TAPEO! and TAPEO?. 


The command input to be substituted for a full and tracks dump are shown below in 


Example LA and Example |B, respectively. To restore the same volume. refer to 
Examples |. 1A. and 1B of the RESTORE command. 
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Example 1: 
//J3OB1 JOB accounting information,REGION=nnnnKk 
//STEP1 EXEC PGM=ADRDSSU 
//SYSPRINT DD SYSOUT=A 
//DASD DD UNIT= 3380, VOL=(PRIVATE,SER=111111) ,DISP=0LD 
{/TAZE si0) UNTT=(3480, 2) VOL=SER= (TAPED, TAPEQZ) , 
// LABEL=(1,SL),O1SP= >= (NEW, CATLG) , DSNAME=USER2. BACKUP 
//SYSIN DD * 

command input (See Examples 1A and 1B below) 
/* 


i 


Example 1A: A Full DUMP Operation 
DUMP INDDNAME(DASD) OUTDDNAME (TAPE) 


Example 1B: A Tracks DUMP Operation 


DUMP =TRACKS(1,0,1,5) INCDNAME(DASD) - 
QUTDDNAME (TAPE) 


Exaneles of Physical Data Set DUMP Operations 
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Example 2 shows specified data sets on DASD volumes 111111 and 222222 being 
dumped to the first data set of standard label tape volume TAPE02. 


Examples 2A through 2G below complement Examples 2A through 2D in the 
RESTORE section, in any combination; for example, the dump tape produced in 
Exampie 2C can be used as the input tape for Example 2A under the RESTORE 
command. 


Example 2: 


Ug ae Ses acTounEing taTormaztion,REGITON=nnnnk 
/S7E2. EXEC PGM*ADROSSL 
//SéS22INT D0 SYSCUT=A 
{//DASTI Bb UNIT T=3380, VOL=(PRIVATE, SER=111111) ,DISP=O0LD 
f/048lZ G2 UNI T#3380, /OL=(PRIVATE,SER=222222) ,DISP=OLD 
[jiart ob UNI T=3480 ,YCLSSER=7A7502, 
// -+3EL=(1,SL) ,DISP=(NEW, CATLG) , OSNAME=USERZ. BACKUP 
TISYSIN D0 bi 

command input (see Examples 2A, 28, ... 2G that follow) 
/* 


Example 2A: Using the INCLUDE Subkeyword 


DUMS  TNDDNAME ¢ fDASDL,DASD2) OUTDDNAS ME(TADE) - 
JATASET (INCLUDE (U ISER2 Seas. *)) 


Example 28: Using the INCLUDE and EXCLUDE Subkeywords 


me PTAaT 


Dus? INCONAME (DAS62,OASOZ: QUTDDNAME ( TAP eg} o- 
DATASET ( INCLUDE(USERZ. ** ,USER3.*) - 
EXCLUDE (USERZ.** REP) ) 


Example 2C: Using the INCLUDE, EXCLUDE, and BY Subkeywords 


DUM? INDDNAME(DASD1,DASD2) OUTDDNAME(TAPE) - 
DATASET (INCLUDE (USER2.**,USER3.*) - 
EXCLUDE (USER2.**.REP) - 
BY ( (DSCHA,EQ,1))) 
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Example 2D: With Filtering Data in a Data Set 
DUMP INDDNAME(DASD1,DASD2) OUTDDNAME(TAPE) - 
DATASET (FILTERDD(A1) ) 


Note: The following DD statement must be added to the JCL shown above: 
//AL OD ODSNAME=USERZ.FILTER ,DLSP=SHR 


This cataloged data set (OSER2.FILTER) contains three card-image records. The 
information shown is positioned in columns 2 through 72 of each record: 


INCLUDE (USER2.** ,USER3.*) - 
EXCLUDE(USER2.**.REP) - 
BY ((DSCHA,EQ,1)) 
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DUMP Command 


Example 2E: With Passwords in the Input Stream 


DUMP INDDNAME(DASD1,DASD2) OUTDDNAME(TAPE) - 
DATASET (INCLUDE (USER2.**,USER3.*)) - 
PASSWORD (USER2. ABC .DEF/PSWD1,USER2.XYZ/PSWD2) 


Example 2F: With Passwords in a Data Set 


DUMP INDDNAME(DASD1,DASD2) OUTDDNAME(TAPE) -.. 
DATASET (INCLUDE (USER2.** ,USER3.*)) - 
PASSWORD (PDD) 


statement must be added to the JCL shown above: 
//PDD OD DSNAME=USER2. PASSWORD ,DISP=SHR 


This cataloged data set (USER2.PASSWORD) contains a single card-image record. 
The information shown is positioned in columns 2 through 72: 


USER2.ABC.DEF/PSWD1,USER2.XYZ/PSWD2 


Example 2G: Wait for Data Sets if They or Other Data Sets with the Same Name 
Are in Use by Other Jobs . : 


DUMP INDDNAME(DASD1) OUTDDNAME(TAPE) - 
DATASET (INCLUDE(**)) - 
WAIT(1,99) 


If a data set is in use, DFDSS waits for one second, then tries to gain access to the 
resource again. This is done as many as 99 times for each data set. 


Examples of Logical Data Set DUMP Operations 


Example 1: Dumping data sets that are constantly in use 


/ /30B2 JOB accounting information, REGION=nnnnk 
/ASTERL EXEC PGM=ADRDSSU 
//SYSPRINT DD SYSOUT=A 
//DASDL DD UNIT=3380, VOL=(PRIVATE, SER=111111) ,DISP=OLD 
/ /DASD2 OD UNIT=3380 , VOL=(PRIVATE, SER=222222) ,DISP=0LD 
//TAPE OD UNIT=3480 , VOL=SER=TAPEQ2, 
// LABEL=(1,SL) ,DISP=(NEW,CATLG) ,DSNAME=USER2. 8ACKUP 
//SYSIN DD . 

DUMP INDDNAME(DASD1) OUTDDNAME (TAPE) - 

DATASET (INCLUDE(**)) TOL(ENQF) WAIT(0,0) 

I aes 


DFDSS does not wait (WAIT(0,0)) if a data set is in use. Instead, it processes the 
data set without serialization or enqueuing (TOL(ENQF)). 


Note: In order to dump an open VSAM data set. you must specify the fully- 
qualified data set name in addition to TOL(ENQF). 
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DUMP Command 
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Example 2: Dumping a User Catalog and its Aliases: To dump a user catalog, you 
perform a logical data set dump with the fully-qualified user catalog name as the 
data set name. No filtering is allowed. If the user catalog has any aliases, the 
aliases are automatically dumped. 


//J30B2 JOB accounting information, REGION=nnnnk 
//STEPL EXEC PGM=ADRDSSU 
//SYSPRINT DD SYSOUT=A . ahs, aM ad Sarn1 ss saad aaees 
//DASD1 DD UNIT=3380, VOL=(PRIVATE,SER=111111) ,DISP=0LD 
//TAPE DD UNIT=3480, VOL=SER=TAPEO2, 
// LABEL=(1,SL) ,DISP=(NEW, CATLG) , DSNAME=USER2. BACKUP 
//SYSIN DD ‘i 
DUMP OUTDDNAME(TAPE) - 
DS (INCLUDE (MY .USER.CAT) ) 
/* 


Example 3: A Logical Data Set DUMP with Catalog Filtering 


//J3OQB3 JCB accounting information,REGION=nnnnk 
//STEPL EXEC PGM=ADRDSSU 
//TAPE DD UNIT=3480,VOL=SER=TAPEO4, 
/( LABEL=(1,SL) ,DISP=(NEW,CATLG) ,DSN=USER3. BACKUP 
//SYSPRINT DD SYSOUT=A : ee: 
//SYSIN DD 6h* 
DUMP OUTDD(TAPE) - 
DS (INCL(USER1.**)) 
* ; ., Be 


All data sets cataloged in the standard search order whose first-level qualifier is 
USERI are to be dumped. Because some of these data sets are multivolume, source 
DASD volumes are not specified, resulting in data set selection by catalog. 


Example 3 can be modified as follows to dump only data sets changed since the last 
backup. In addition, data sets that end with a qualifier of LISTING are not to be 
dumped (EXCL(**.LISTING)). 


//SYSIN DD * 
DUMP OUTDD(TAPE) - 
DS(INCL(USER1.**) - 
EXCL(**.LISTING) - 
BY((DSCHA EQ 1))) 
/* 


Example 4: A Logical Data Set DUMP with VTOC Filtering 


//30B5 JOB accounting information, REGION=nnnnk 
//STEP1 EXEC PGM=ADRDSSU 
//SYSPRINT DD  SYSQUT=A 
//DASD1 DD VOL=SER=338001,UNIT=3380,DISP=0LD 
//TAPE DD UNIT=3480,VOL=SER=TAPE04, 
// LABEL=(1,SL) ,DISP=(NEW,CATLG) ,DSN=USER3.BACKUP - 
//SYSIN DD 6* 
DUMP DATASET(INCLUDE(USER3.**)) - 
LOGINDDNAME(DASD1) - 
OUTDDNAME(TAPE) - 
DELETE PURGE 
/* 


All data sets on volume 338001 whose first qualifier is USER3 are included in a 
logical data set DUMP. DFDSS filters using the VTOC of volume 338001. Cata- 
logs are also used, as needed, for multivolume and VSAM data sets. 
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Example 4 can be modified as follows to dynamically allocate volume 338001 and to 
perform ALLMULTI processing. All single volume data sets on volume 338001 are 
included in a logical data sett DUMP. ALLMULTI specifies that a cataloged data 
set residing on volumes 338001, 338003, and 338005 will be dumped even though 
338003 and 338005 are missing from the LOGINDYNAM volume list. 


//J0B6 JOB accounting information, REGION=nnnnk 
//STEPI EXEC PGM=ADRDSSU 
' //SYSPRINT DD SYSOUT=A 
//TAPE DD =©6 UNI T= 3480 , VOL=SER=TAPE04, 
// LABEL=(1,SL) ,DiSP=(NEW,CATLG) ,DSN=USER3. BACKUP 
//SYSIN DD * 
DUMP DATASET(INCLUDE(**)) - 
ALLMULTI - 
LOGINDYNAM(338001) - 
OUTDDNAME (TAPE) - 
DELETE PURGE 
/* 


Example 5: A Logical Data Set DUMP for Storage Management Subsystem (SMS) 


//MYJOB JOB accounting information, REGION=nnnnk 
//STEP1 EXEC PGM=ADRDSSU : : 
//SYSPRINT DD SYSOQUT=A 
//TAPE DD UNIT=3480,VOL=SER=TAPEO4, 
// LABEL=(1,SL) ,DISP=(NEW,CATLG) ,DSN=USER3 . BACKUP 
//SYSIN DD 6* tee ahs . a a Pes oat, ; 
DUMP LOGINDYNAM(338001) - 

ALLMULTI - 

DATASET (INCLUDE(**)) - 

QUTDDNAME (TAPE) - 

DELETE 
j* 


A volume is backed up for converting to or from SMS management by using a 
logical data set DUMP. 
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PRINT Command 


With the PRINT command, you can print: 


e A single-volume non-VSAM data set, as specified by a fully-qualified name. 
You must specify the volume where the data set resides, but you do not need to 
specify the range of tracks it occupies. 


0 A single-volume VSAM data set component (not es The somponenti name 


specified must be the name in the Format | DSCB in the VTOC, not the name 
in the catalog. 


¢ Ranges of tracks. 
e All or part of the VTOC. The VTOC location need not be known. 


Note: In order to print a multivolume data set, multiple PRINT commands with 
the appropriate INDD/INDY keywords must be used. 


Unless ALLDATA is specified, only the used space is printed for SAM or PAM 
data sets or data sets with a null DSORG field. 


If an error occurs in reading a record, DFDSS attempts to print the record in error. 
You can print all requested tracks or just a subset of the tracks that have data 
checks. For more information about authorization checking, see Appendix B, 
“Serialization and Authorization Checking” on page 165. 


PRINT Command Syntax ae 
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Optional Keywords a DATASet 





ALLData DATALength(n) YNALToc ERRortracks 


KEY length(n) UTDOnam (ddn) SHAr 
, , D SH 


PASsword——(—-—ddn ) 
pswo 


catnam 
L/psnd 
s 
TOLerate-(—;-I0ERro ) 
‘li ENQFailur 
ENQFai lure 
TOERro 








AIT(numsecs,numretries) 


Optional Keywords a. TRACKS or VTOC 





DATALength(n) ERRortracks KEYlength(n) 


OUTDOname——(ddn) 
poe 


PASsword—~( ddn )H 
aan 
catname 
/pswd 
dsn 


TOLerate-(—IOERror—) 











WAIT (numsecs ,numretries) 


Explanation of PRINT Command Keywords 


ALLData 





ALLData 


specifies, when the DATASET keyword is also specified, that all allocated space in 
the data set is to be printed. 
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DATALength 


DATASet 


DYNALIoc 


ERRortracks 


INDDname 
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LoataLength (n)- 


n 
specifies the logical length, in decimal format, of the data portion of a record. It is 
used only if the count field of a record on any track has a data check. 





DATASet-—7—(dsn) 


dsn 
specifies the fully-qualified name of the data set to be printed. The data set is 
printed in logical sequence. 


Note: Data set filtering is not allowed with the PRINT command. 


VSAM catalogs are not supported for data set processing. If VSAM catalogs are 
processed, the results can be unpredictable. 


Dynan ra 


specifies dynamic allocation, instead of enqueue, to serialize the use of data sets. 
This allows cross-system serialization in a JES3/MVS environment. 
Consider: 


¢ The serialization is of value only when the dynamic allocation/ JES3 interface is 
not disabled. 


¢ SVC 99 is used to serialize data sets. 


¢ Run time increases when you use DYNALLOC to serialize data sets (as opposed 
to enqueue) because overhead is involved in dynamic allocation and serialization 
across multiple processors. 


¢ Using INDYNAM instead of DD statements to allocate DASD volumes does 
not appreciably increase run time and permits easier coding of JCL and 
command input. 


Leprort ee 


specifies that only tracks on which data checks occur are to be printed. 





safc Gk 
—100——— 

ddn 

specifies the name of the DD statement that identifies a volume that contains the 
data set, range of tracks, or the VITOC to be printed. If you want to print a multi- 
volume data set, you must print one volume at a time. 


INDYnam 


KEYlength 


OUTDDname 





PASsword 


PRINT Command 


INDYna eg ae | eeerrer 

¥—_ sunit 
specifies that the volume that contains the data set, range of tracks, or the VTOC to 
be printed is to be dynamically allocated. If real (not virtual), the volume must be 
mounted and online. 


volser 

specifies the volume serial number of a DASD volume to be printed. 

unit 

specifies the device type of a DASD volume to be printed. This keyword is optional. 





KEYlength(n) 


i; | 
specifies the key length, in decimal format, of a record. It is used only if the count 
field of a record on any track has a data check. 


UTDOnam (dd ) 
: name~—(ddn 


ddn 

specifies the name of the DD statement that identifies the (output) print data set. 
Each of the DD statements corresponding to a DDNAME (ddn) must identify only 
one volume serial number. If this keyword is not specified, the default is 
SYSPRINT. 


Notes: 


1. If the DCB keyword LRECL is specified on the DD statement, it must be in the 
range of 84 to 137 inclusive. If BLKSIZE is specified, it must be at least four 
greater than the LRECL. 


Ny 


. If an LRECL less than 84 is chosen, the return code is 8 and an error message is 
issued. 


3. If the specified LRECL is greater than 137, LRECL and BLKSIZE are set to 
137 and 141, respectively. 


L Password (+—ddn al 
eso —_ 
aa 
catname 
L-/osud 
dsn 


specifies the passwords DFDSS is to use for password-protected data sets. (Pass- 
word checking is bypassed for RACF-protected data sets.) This is required only if: 


¢ You do not have the required volume-level RACF DASDVOL or RACF 
DATASET access. 





¢ The installation authorization exit does not bypass the checks. 


¢ You do not want to be prompted for the password. 
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SHAre 


TOLerate 


TRACKS 
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For VSAM data sets, passwords are checked at the cluster level only. 
Note: The PASSWORD keyword is not valid for a PRINT VTOC command. 


ddn 

specifies the name of the DD statement that identifies the sequential data set, or 
member of a partitioned data set, that contains data set names and their passwords. 
This data set must contain card-image records in DFDSS command syntax format. 


dsn|pswd 


dsn is a fully-qualified data set name. pswd is its password. If no password follows 
the slash (/), dsn is treated as though it were ddn. 


Printing of actual data set passwords specified in your input command stream is sup- 
pressed in the SYSPRINT output. 


Passwords for password-protected VSAM data sets must be supplied by the oper- 
ator. They cannot be supplied with the input stream. They are required on tracks 
PRINT operations only. : 


[stare 
SHR 


specifies that DFDSS is to share, for read access with other programs, the data set 
that is to be printed. 





t 
—TOLerate-(—~—I0ERror )— 
aE Lengrat ure | 
ie aan ore a 
IQERroa 


ENQFailure 

specifies that data sets are to be processed even though shared or exclusive access 
fails. For more information on TOL(ENQF), see Appendix B, “Serialization and 
Authorization Checking” on page 165. 


IOERror 
specifies that DFDSS is to continue processing even though I/O errors occur, but is 
to end after 100 errors. . 


pase Saeed TRACRS ee ree 
LteKs— shl 
mer 
sho 


specifies ranges of tracks to be printed. 


cl,hl 
specifies the cylinder and head number of the beginning of the range. Specify 
hexadecimal numbers as X'cl' or X'hl'. 


c2,A2 

specifies the cylinder and head number of the end of the range. Specify hexadecimal 
numbers as X'c2' or X'h2'. The c2 must be greater than or equal tocl. If c2 
equals cl, h2 must be greater than or equal to hl. 


~ “PRINT Cominand 
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DFDSS verifies that the range is within the limits of the device. If you do not 
specify all four values for a range, DFDSS provides the missing values unless the 
omitted value causes a syntax error. No intervening values can be omitted. For 
example: 


Specified Results 


None ‘Syntax error 5 
cl c1,0,clhmaximum head number 
cl hl cl,hl,cl,maximum head number 


cl Al,c2.—cl,hl,c2, maximum head number 
cl,,c2 Syntax error 


yhl Syntax error 


VTOc 


SS SSS 


specifies that all or part of the VTOC is to be printed. Omitting the VTOC, 
-DATASET, and TRACKS keywords causes the entire VTOC to be printed. Part of 
the VTOC can be printed by specifying: 


YTOC (a,b) 
where a and b are the relative track numbers (1 is the first track) of the first and last 
tracks to be printed. The value of b must be equal to or greater than the value of a 


and equal to or less than 65535 (X'FFFF'). Either of these numbers can be speci- 
fied in decimal or hexadecimal. To specify a hexadecimal number, code X'nn'. 


If only the first value (a) is specified, only that track is printed. 


If the second value (5) is greater than the relative track number of the last physical 
track of the VTOC, DFDSS prints up to and including the last track of the VTOC. 
Therefore, another way of printing the entire VTOC would be to specify: 
VTOC(1,X'FFFF') 


Note: The PASSWORD keyword is not valid for a PRINT VTOC command. 


WAIT 
Lyart (numsecs ,numretri al 


specifies to DFDSS the length of a wait in seconds and the number of retries to 
obtain control of a volume or a data set. 


numsecs 
is a number from | to 255 that specifies the interval, in seconds, between retries. 


numretries 
is a l- or 2-digit number that specifies the number of times an attempt to gain 
control of a volume or data set is to be retried. 


The default for numsecs,numretries is (2,2), which specifies two retries at 2-second 


intervals. If you do not want to wait for a resource, specify 0 for either numsecs or 
numretries. 
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Examples of PRINT Operations 
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ye 


Example 1: Print a Data Set 


//30B1 JOB accounting information, REGION=nnnnK 

//STEPL EXEC PGM=ADRDSSU 

//SYSPRINT DOD SYSOUT=A 
//DASD DD UNIT=3380 , VOL=(PRIVATE, SER=111111) ,DISP=OLD 
//SYSIN DD * . 

PRINT DATASET(USER2.COMPILE.LIST) INDDNAME(DASD) - 

SHARE PASSWORD (USER2.COMPILE.LIST/PSWD1) 
/* 


Print a hard copy of data set USER2.COMPILE.LIST residing on volume 111111. 


Example 2: Print a Range of Tracks 


//J30B2 JOB accounting information, REGION=nnnnk 

//STEP1 EXEC PGM=ADRDSSU 

//SYSPRINT DD SYSOUT=A 

//DASD DD UNIT=3380, VOL=(PRIVATE,SER=111111) ,DISP=0OLD 
//SYSIN DD * 

PRINT TRACKS(1,0,1,5) INDDNAME(DASD) — 


Print a hard copy of tracks 0 through 5 from cylinder 1 on volume 111111. 


Example 3: Print a Component of a VSAM Cluster 


//30B3 JOB accounting information, REGION=nnnnK 

//STEP1 EXEC PGM=ADRDSSU 

//SYSPRINT DD SYSOUT=A 

//SYSIN ob 

PRINT INDYNAM(338000) /* ALLOC VOL 338000 DYNAMICALLY */ - 

DS(PARTS.VSAML. INDEX) /* DATA SET THAT HAS BAD TRACK */ - 
WAIT(0,9) /* DO NOT WAIT IF ENQ FAILS */ - 
TOL(ENQF) /* IGNORE ENQ FAILURES ae ae 
PSWD(PARTS.VSAM1/USERPSWD) /* PASSWORD FOR CLUSTER */ 

[* 


A component of a VSAM data set is to be printed. The printing is to proceed even 
if the component cannot be serialized (enqueued). 


Example 4: Print a Data Set 


//3OB4 JOB accounting information,REGION=nnnnk 
JASTEPL EXEC PGM=ADRDSSU 
//SYSPRIN? DD SYSOUT=* 
//001 OD VOL=SER=D8E040, UNIT=3380 ,DISP=0LD 
//SYSIN DD * 

PRINT INDD(DD1) DS(PRINT.SAMPLE) 
[= 


The output shown in Figure 6 on page 91 was produced from the control statement: 
PRINT INDO(9D1) DS(PRINT.SAMPLE) 


Note: If the last record on the track is a track overflow record, the count field of 
the record is followed by (+). 





ee rn ee i 


PAGE Q0Q1 DFDSS 5665-327 DATA FACILITY DATA SET SERVICES V2R5.0 89.067 16:08 


PRINT INDD(DD1) DS(PRINT. SAMPLE) 
ADR1011 
ADR1091 RIO1 (61), 89067 16: 
ADROO6I (001)-SETLP(Q1), 89067 16: 
*** TRACK(CCHH) 66010000 

COUNT 9001000601080100 
— 0000 FFFFFFFF FFFFFFFF 6026D4C5 
0020 O60OFFFF FFFFFFFF FFFFOQQ00 
0040 O0GCO000 COGGO000 GOQ0R000 
@060 TO OOFF SAME AS ABOVE 
9100 00000000 GNGe0000 
COUNT 0001000002080100 
COUNT 0001000603000000 
COUNT 00010000040000A0 
Q000 C1C2C3C4 C5C6C7C8 C9D1D2D3 
0020 F6F7F8F9 C1C2C3C4 C5C6C7C8 
0040 F2F3F4F5 FOF7F8F9 C1C2C3C4 
0060 D9EZE3E4 E5SE6E7E8 ESFOFIF2 
@080 05060708 D9EZE3E4 ESE6E7E8 
COUNT 9001000605000000 
COUNT Q00100C00EQQGOFO 
9000 C3C4C5C6 C7C8C9D1 D2D3D4D5 
Q020 F8FSCIC2 C3C4C5C6 C7C8C9D1 
0040 FA4F5F6F7 F8F9CIC2 C3C4C5C6 
0060 E3E4E5E6 EVESESFO FIF2F3F4 
0080 OD7D8D9E2 E3E4E5E6 E7ESE9FO 
QOAD = C5C6C7C8 C9P2D203 D4DSD6D7 
QECO C1C2C3C4 C5C6C7C8 C9D1D2D3 
QOEO FOF7F8F9 C1C2C3C4 C5C6C7C8 
COUNT 9001000607000000 
ADRO13I (001)-CLTSK(01), 89067 16: 
ADRO121 


150000 


RIO1 (01), TASKID 001 HAS BEEN ASSIGNED TO COMMAND 'PRINT ' 


08:40 INITIAL SCAN OF USER CONTROL STATEMENTS 
08:40 PROCESSING BEGINS 
RQ DATA 0000000000000000 


D4FOF140 
00600000 
00000000 


40400000 0400D4C5 D4FOF240 40400000 
80000000 00000880 88660080 00000000 
Q00QOOOO H0000000 00090000 H0000000 


ALL KEY/DATA 00 


04D5D607 
C90102D3 
C5C6C7C8 
F3F4F5F6 
EQFOFLF2 


D8D9E2E3 
D4D5D6D7 
C2C3C4C5 
F7F8F9C1 
F3F4F5F6 


E4E5E6E7 ESE9FOFL F2F3F4F5 
D8D9EZE3 E4E5E6E7 ESESFOF1 
C6C7C8C9 D1D2D3D4 05D6D7D8 
€2C03C4C5 C6C7C8C9 D1D2D3D4 
F7F8F9C1 C2C3C4C5 C6C7C840 


E2E3E4E5 
D6D7D8D9 
C4C5C6C7 
F9C1C2C3 
FSF6F7F8 
E4E5E6E7 
D8D9E2E3 


E6E7ESE9 
E2E3E4E5 
C8C9D1D2 
C4C5C6C7 
F9C1C2C3 
E8E9FOF1 
E4E5E6E7 


FOFIF2F3 FA4F5F6F7 
E6E7E8E9 FOFLF2F3 
D3D4D5D6 D7D8D9E2 
C8C9D1ID2 D3D4D5D6 
C4C5C6C7 C8404040 
F2F3F4F5 FOF7F8F9 
ESE9FOF1 F2F3F4F5 


D6D7D8D9 
D2D3D4D5 
C7C84046 
F5F6F7F8 
FIF2F3F4 
D8D9EZE3 
D4D5D607 
40404040 


08:40 TASK COMPLETED WITH RETURN CODE 0000 


Figure 6. Output Resulting from a PRINT Command 
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“PRINT Command 


COMPLETED. 


*ABCDEFGHIJKLMNOPQRSTUVWXYZ012345* 
*6789ABCDEFGHI JKLMNOPQRSTUVWXYZO1* 
*23456789ABCDEFGHBCDEFGHI JKLMNOPQ* 
*RSTUVWXYZ0123456789ABCDEFGHI JKLM* 
*NOPQRSTUVWXYZ0123456789ABCDEFGH. * 


*CDEFGHI JKLMNOPQRSTUVWXYZ01234567* 
*89ABCDEFGHI JKLMNOPQRSTUVWXYZ0123* 
*456789ABCDEFGH. . DEFGHIJKLMNOPQRS* 
*TUVWXYZ0123456789ABCDEFGHI JKLMNO* 
*PQRSTUVWXYZ0123456789ABCDEFGH. ..* 
*E°SHIIKLMNOPQRSTUVWXYZ0123456789* 
*ABCDEFGHIJKLMNOPQRSTUVWXYZ012345* 
*6789ABCDEFGH.... ie 


DSSU (61), 89067 16:08:41 DFDSS PROCESSING COMPLETE. HIGHEST RETURN CODE IS 0000 
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RELEASE Command 


The RELEASE command releases, on a specified volume(s), allocated but unused 
space from all sequential and partitioned data sets that you select with INCLUDE, 
EXCLUDE, or BY criteria. For an explanation of these criteria, see Chapter 2, 
“Choosing the Data Sets You Want sic a a on n page 9. DFDSS oy 
selects data sets that have releasable space. - 


Note: The RELEASE function requires MVS/XA DFP Version 2 Release 1.0 or a 
later release. 


You must exclude, by using the EXCLUDE keyword, data sets whose DSILSTAR 
(last block pointer in the Format 1 DSCB) field is not maintained in the VTOC. 
This can occur if you use an access method other than BSAM, QSAM, or BPAM. 
DFDSS does not release space for data sets whose DSILSTAR field is 0. 


| pe 


(ddn) 


RELEASE Command Syntax 


>>—RELease —_-_ — ( 





FiLterd 
FD 


saat ak 


DYNAM ( Pegi eee 
unit 


I 


Additional Keywords a with RELEASE 


eae 





ere a 











ln El 


osen dl 


| 
14 





eas el 






Pana 


hee LI schar,op, b woh 







BY (¢(—schar,op, ( 





Lok EXC] ae 
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RELEASE Coinimand 


Optional Keywords 








DYNALIoc INSECqty (n) INTRAcksunused—7~(n) 
INTRKS=<——-—-_—_|_ 
PASswor (- - ) 
a eT 
eathane 
/pswd 
usr 

| 
| PROCESS (SYS1) 


Leeriesecceatenge| a dels Siedrs oO 


eapianatien of RELEASE Command Keywords 
The following applies to the RELEASE command: 


e A data set with 16 allocated extents will not have any space released. 
¢ Free tracks in cylinder-allocated extents are not released. Only free cylinders are 
released. 
| ¢ DFDSS excludes system data sets beginning with SYS1, unless the PROCESS 
keyword is used. 


ne 
>—BY ( (-schar, cco, (warg-)-) 7 
CT auld 
INCLUDE (¥dsn4)—  LEXCT ude (ydsn+) 


specifies that the data sets selected up to this point, by the processing of the 
INCLUDE and EXCLUDE keywords, are to be further filtered. To select the data 
set, all BY criteria must be met. See the separate discussions of INCLUDE and 
EXCLUDE for information on how these keywords are specified. 


BY 










DDName 
‘on 


Gare} 





>——DOName ( 





specifies the name of the DD statement that identifies a volume whose sequential 
and partitioned data sets, if selected, are to have their unused space released. To 
assure correct processing, each of the DD statements corresponding to a DDNAME 
(ddn) must identify only one volume serial number. 
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ve ee 
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RELEASE Command > 


DYNALIoc 


DYNAM 


EXClude 


Filterdd 
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Loynaut oc) 


specifies dynamic allocation, instead of the ENQ macro, to serialize the use of data 
sets. This allows cross-system serialization in a JES3/MVS environment. 


Consider: 


e This serialization is of value only when the dynamic allocation/JES3 interface is 
not disabled. 


e SVC 99 is used to serialize data sets. 


¢ Run time increases when you ure DYNALLOC to serialize data sets (as opposed 
to enqueue) because overhead is involved in dynamic allocation and serialization 
across multiple processors. 


Seren ; | re = 


specifies that the volume to be processed is to be dynamically allocated. If the 
volume is real (not virtual), it must be mounted and online. Using DYNAM instead 
of DD statements to allocated DASD volumes will not appreciably increase run time 
and permits easier coding of JCL and command input. 


volser 

specifies the volume serial number of a DASD volume to be processed. 

unit 

specifies the device type of a DASD volume to be processed. This keyword is 
optional. 


m—(EXC] Poe 





eal im | 
lice, arg~)+) 
dsn 


specifies the name of a data set to be excluded from the data sets selected by 
INCLUDE. Either a fully- or a partially-qualified data set name can be used. See 
the separate discussions of INCLUDE and BY for information on how these 
keywords are specified. 





»>—-F ILterdd (ddn) 
—F00 

ddn 

specifies the name of the DD statement that identifies the sequential data set or 

member of a partitioned data set that contains the filtering criteria to use. This is in 

the form of card-image records, in DFDSS command syntax, that contain the 

INCLUDE, EXCLUDE, and BY keywords that complete the RELEASE syntax. 


Note: You must use FILTERDD when you have more than 255 entries in the 
INCLUDE, EXCLUDE, or BY list of subkeywords. 


RELEASE Command 


INCiude 


m—(INCI mapa. 





EXClude( a. 


lee. , 7) 
dsn 


specifies the name of a data set whose unused space is eligible to be released. Either 
a fully- or a partially-qualified data set name can be used. See “Filtering by Data 
Set Names” on page 10. If INCLUDE is omitted (but EXCLUDE or BY is speci- 
fied) or if INCLUDE(**) is specified, a// data sets are eligible to be selected for 
releasing. See the separate discussions of EXCLUDE and BY for information on 
how these keywords are specified. 


MINSECaqty 


Lutnsecqty(n)— 


Because all the allocated but unused space will be released when you do not specify 
a secondary allocation quantity, you will not be able to add records to the data set 
after the RELEASE operation. MINSECQTY solves this problem. The RELEASE 
operation is not performed unless the secondary allocation quantity in the VTOC is 
equal to or greater than 7 tracks and the data set has not reached 16 extents. nisa . 
1- to 5-digit decimal number with a range from 0 to 99999. If MINSECQTY (n) is 
not specified, a default of 1 track is used. 


MINTRAcksunused 





INTRAcksunused-7—-(n) 
PMTRAcksunused 


specifies that the RELEASE operation is to be performed only if the number of 
unused tracks for a selected data set is equal to or greater than n, where n is a 1- to 
5-digit decimal number. When MINTRKS is not specified, a default value of 1 is 
used. If a RELEASE is done, a// unused tracks will be released. 


PASsword 
PASsword-7—( ddn ) 
pswD—— 


catiane 
/pswd 
dsn 
specifies the passwords DFDSS is to use for selected password-protected sequential 
and partitioned data sets. (Password checking is bypassed for RACF-protected data 
sets.) This is required only if: 


¢ You do not have the required volume-level RACF DASDVOL or RACF 
DATASET access. 


e The installation authorization exit does not bypass the checks. 
¢ You do not want to be prompted for the password. 


ddn 

specifies the name of the DD statement that identifies the sequential data set or 
member of a partitioned data set that contains data set names and their passwords. 
This data set must contain card-image records in DFDSS command syntax format. 
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RELEASE Command 


~ PROCESS 


WAIT 


dsn/pswd 
dsn is a fully-qualified data set name. pswd is its password. If no password follows 
the slash (/), dsn is treated as though it were ddn. 


Printing of actual data set passwords specified in your input command stream is sup- 
pressed in the SYSPRINT output. 


PSS lp 9 Oe ee er ee eee a se eet ee 
Ls Sonocess (sisi) = 

specifies that the RELEASE operation is to be performed for data sets with a high- 

level qualifier of SYS1. To specify PROCESS, you must have the proper RACF 


Facility Class authorization. Refer to Resource Access Control Facility (RACF) 
Security Administrator’s Guide for additional information. 


Lyart (numsecs,numretri ae 


specifies to DFDSS the length of a wait in seconds and the number of retries to 
obtain control of a volume or serialize a data set. 


Anumsecs 
is a number from | to 255 that specifies the interval, in seconds, between retries. © 


nurmretries 
is a 1- or 2-digit number that specifies the number of times an attempt to gain 
control of a volume or data set is to be retried. 


The default for numsecs,numretries is (2,2), which specifies two retries at 2-second 
intervals. If you do not want to wait for a resource, specify 0 for either numsecs or 
nurmretries. 


Example of a RELEASE Operation 
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A RELEASE Operation on Selected Sequential and Partitioned Data Sets 


//JQBi JOB accounting information, REGION=nnnnk 

//STEP1 EXEC PGM=ADRDSSU 

//SYSPRINT DD SYSOUT=A 

//SYSIN OD.. * 

RELEASE INCLUDE(**) - 
DYNAM (338000) /* DYNAM ALLOC VOL 338600 of aes 
MINTRKS (10) /* THERE ARE 10 OR MORE UNUSED TRKS */ - 
/* MINSEC NOT SPEC. IT DEFAULTS TO 1 */ 
{= 


Unused tracks of sequential and partitioned data sets on volume 338000 are to be 
released if both: 
¢ The number of unused tracks in the data set is greater than or equal to 10. 


¢ The data set can be extended later if required (MINSEC(1)). This need not be 
specified, because it is the default. . 


~~ RELEASE Command” ” 


5 abel a eS eae: 


Fp SR A BT ae eng ce ee BE Reed ate 


The above example can be modified as follows to release unused tracks of all 


sequential and partitioned data sets, other than system data sets, that have any 
unused tracks: 


//SYSIN. DD * 
RELEASE INCLUDE(**)  - 


DYNAM (338000) /* DYNAM ALLOC VOL 338000 */ 
/* 
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RESTORE Command 


RESTORE Command 


With the RESTORE command, you can restore data to a DASD volume(s) from a 
DFDSS-produced dump volume(s). You can restore data sets, an entire volume, or 
ranges of tracks. You can restore to unlike devices from a logical dump tape. 


Note: The FULL keyword for the RESTORE command specifies that an entire 


DASD volume is to be restored. The TRACKS keyword for RESTORE specifies © 


ranges of tracks to be restored. 


DFDSS offers two ways to process RESTORE commands: 


¢ Logical processing is data-set oriented, which means it operates against data sets 
and volumes independently of physical device format. 


¢ Physical processing can operate against data sets, volumes, and tracks, but is ori- 
ented toward moving data at the track-image level. 


The processing method is determined by what type of dump tape is used as. input 
and by the keywords specified on the command. 


" DFDSS logical RESTORE processing cannot be used to process PAM data sets con- 


taining location-dependent information that does not reside in note lists or in the 
directory. For example, PDS load libraries that contain overlay pees are > not 


“supported during logical RESTORE processing:* 


For more information on using the RESTORE command, see Data Facility Data Set 
Services: User’s Guide. 


RESTORE Syntax for FULL or TRACKS 
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pe—2ESTore- 


| 
L—TRACKS i )4) 
} i ' 
LrRKsS—— shL 
+c2 
yh2 









»>———INDOnam (ddn) 
Spee 
OUTDOname——(ddn) 
pee 
[ 


, 
—ouToYnan—— ie volser 


i oe 
L_opy———3 ,unit 


Optional Keywords a: with FULL 


“RESTORE Command ~ 





CANcelerro COPYVoli 
CPYV 
ivopebe le Fae 
PS 
catnam 
/pswd 
sn 
PURg AIT(numsecs,numretries) Ritecheck 
PRG RC 


Optional Keywords ro with TRACKS 











LoutteKs 


eer he —————)} 






PASsword——( ddn—--_-—__-__—) 
Soni - 
/pswd 


| | aes 
dsn 


PURge— WAIT (numsecs ,numretries) WRI techeck 
Prue Pitecnect 


Logical Data Set RESTORE Command Syntax 
PReStGhery wa pact 


—DS 





FILterdd——(ddn) 
cpoaone e 


oo 
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“RESTORE Command 


Additional Keywords qa with DATASet 
CE 


>——INC] lel 






EXC] aia 
INClude sia ; 


BY | schar,op, fal 





‘a Cl 


XClude Ae 





INClude sme 


100 DFDSS: Reference 


TS ae nae Ph Be aa a! ae aes 


- RESTORE Command 


Optional Logical pa Set RESTORE Keywords 


Lrorce— Leet (aodel sn) 7 


VOlser(volser) 








NOPACKi ee De 










eee (vol ———h 
OY ,unit 


san al 







PERCENTUti lized i 
ci], 


: eee 






REName (pfx) 
( 


(pfx), ee 


| -Renaveuncondi tional (pfx) 
RENUNC a 
eae ) 


(pfx), jaar 


SPHERE TGTATloc—(——BLK ) 
CYL 
TRK 
SOURCE 


SRC 








Chapter 3. Syntax—Function Commands 101 


‘ 3 ah gee he Siaides “os wer, 
PO eR RSE TE CEA ee ey tg a Oo rae hy ge te Oe. SE Te ag te ae Panaderia die Sg pega OBER AL a dane gb = cae Beye | PANE DEE ES igs ghee gg tyra gees 2 a ted a he 


Physical Data Set RESTORE Command Syntax 
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Optional Logical and Physical Data Set RESTORE Keywords 


: CANcelerro CATalog 
L i RECATalog(newcatname) 
BYPASSACS (wdsn-+) RECATalog(*) 





RESTORE Command 


Ree gc 





GMTCLAS (management-cl ass~name)- 
NULLMGMTCLAS: 


PASsword—7( dn ) REPT ac SHAr 
oe SHR 
catnam 
/pswd 
sn 


STORCLAS (storage-class—name) 
Trwuussroncias 











—TETGDS—( 


—TOLerate-(ENQFai lure) 





i ; 
—WAIT(numsecs,numretries) 





Explanation of RESTORE Command Keywords 


to CU | 
INClude( il eagle 


specifies that the data sets selected up to this point, by the processing of the 
INCLUDE and EXCLUDE keywords, are to be further filtered. To select the data 
set. all BY criteria must be met. See “Filtering by Data Set Characteristics” on 
page 12 for further information. Also, separate discussions of INCLUDE and 
EXCLUDE provide information on how these keywords are specified. 


BY 
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BYPASSACS 


CANcelerror 


~ "RESTORE Command 


eek. 


specifies that Automatic Class Selection (ACS) routines are not to be invoked to 
determine the target data set’s storage class or management class names. In order to 
bypass ACS filtering, the user must have RACF Facility Class authorization. See 
Data Facility Data Set Services: User’s Guide for profile names. 


Pe 


specifies that the RESTORE is to be stopped if a permanent read error occurs. If 
CANCELERROR is not specified, DFDSS attempts to recover from input errors, 
but the results can be unpredictable because of the difficulty in repositioning and 
assembling the data. 


CATalog or RECATalog 


~— L-CATalog- 
RECATal og(newcatname) 
RECATalog(*) 


For a logical RESTORE, CATALOG instructs DFDSS to catalog data sets that it 
allocates. For a physical RESTORE, CATALOG is used for non-VSAM single 
volume data sets; RECATALOG is ignored. 


CATALOG 

catalogs the target data set in a catalog as determined by the standard catalog search 
order. This is the default for VSAM data sets. multivolume data sets, and 
SMS-managed data sets (during logical data set restore). 


RECATALOG(newcatname) 
catalogs the target data set in the newcatname catalog. 


RECATALOG(*) 
catalogs the target data set in the same catalog that points to the source data set. If 
the source data set was not cataloged, the new data set is not cataloged either. 


Notes: 


1. CATALOG or RECATALOG fails if the target data set is already cataloged in 
the same catalog and either RENAME is not specified. 


2. CATALOG and RECATALOG are ignored when the target data set is preallo- 
cated. 


3. RECATALOG is ignored for SMS-managed data sets. 


4. Be careful when using RECATALOG(newcatname) because the target data set 
may already be cataloged outside of the standard order of search. 


. CATALOG must be specified to catalog non- VSAM SMS-managed data sets 
during physical data set restore. 


Cn 
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COPYVolid 
Heuer ie] 
PYY 


specifies that the VOLID from the dumped DASD volume is to be copied to the 
output DASD volume. This applies to a full RESTORE operation; it applies to a 
tracks RESTORE only if track 0 is to be restored. 


When the volume serial number on a DASD volume is changed, the volume serial 
field in the UCB of the receiving volume is cleared and the operator is notified. The 
operating system then initiates either: 


¢ A demount if there is another volume with the same serial number 
e A mount to get the volume with the new serial number mounted. 


This might change the mount attributes of the volume. You should exercise oper- 
ating precautions if there are two or more processors sharing the same DASD 
volume. 


When the volume serial number is changed by using a COPYVOLID keyword or. 
when both the dumped volume and the volume to be restored have different serial 
numbers, profiles are not built for the RACF-protected data sets on the restored 
volume or ror the RACF DASDVOL for RACF-protected DASD volumes. 


Notes: 


1. If you are doing a full RESTORE and the input has VSAM data sets, the 
VOLID must be copied. 


2. COPY Volid is required for a full volume RESTORE of SMS-managed source 
volumes. 


DATASet 
re ee Oe eae a Ne See 
~95 
specifies a data set RESTORE operation, using filtering. See Chapter 2, “Choosing 


the Data Sets You Want Processed—Filtering” on page 9 for an explanation of the 
filtering process used. 


Notes: 


1. Either the FILTERDD or the INCLUDE keyword must be substituted when 
DATASET is selected. 


bho 


. VSAM catalogs are not supported for data set processing. If VSAM catalogs 
are processed, the results can be unpredictable. 


DYNALIloc 
Tey ee ee ee ee ee 
LoyNALloc— 
specifies dynamic allocation, instead of enqueue, to serialize the use of data sets. 
This allows cross-system serialization in a JES3/MVS environment. 


Consider: 


¢ The serialization is of value only when the dynamic allocation/JES3 interface is 
not disabled. 


¢ SVC 99 is used to serialize data sets. 
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e Run time increases when you use DYNALLOC to serialize data sets (as opposed 
to enqueue) because overhead is involved in dynamic allocation and serialization 
across multiple processors. 


e Using INDYNAM instead of DD statements to allocate DASD volumes does 
not appreciably increase run time and permits easier coding of JCL and 
command input. 


»—EXC]ude-( aul 





INClude( i 





ee LMI ~schar,op, (ya 
dsn 


specifies the name of a data set to be excluded from the data sets selected by 
INCLUDE. Either a fully- or a partially-qualified data set name can be used. See 
the separate discussion of INCLUDE and BY for information on how Oey 
keywords are specified. 





ddn 

specifies the name of the DD statement that identifies the sequential data set or 
member of a partitioned data set that contains the filtering criteria to use. This is in 
the form of card-image records, in DFDSS command syntax. containing the 
keywords INCLUDE, EXCLUDE, and BY that complete the RESTORE syntax 
below. 


Note: You must use FILTERDD when you have more than 255 entries in the 
INCLUDE, EXCLUDE, or BY list of subkeywords. 


L Force 


r 


For a logical data set RESTORE, FORCE specifies that DFDSS will allow an 
unmovable data set or a data set allocated by absolute track allocation to be moved. 


FORCE does not apply to ISAM data sets. 


FULL 
FUL 


specifies that an entire DASD volume is to be restored. This is the default. 


Notes: 
1. You cannot specify SHARE or TOL(ENQF) for FULL operations. 


2. VSAM catalogs are not supported for full volume processing. If VSAM catalogs 
are processed, the results can be unpredictable. 
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specifies the name of a data set eligible to be restored. Either a fully- or a partially- 
qualified data set name can be used. See “Filtering by Data Set Names” on 

page 10. If INCLUDE is omitted (but EXCLUDE or BY is specified) or if 
INCLUDE(**) is specified, a// data sets are eligible to be selected for restoring. See 
the separate discussions of EXCLUDE and BY for information about how these 
keywords are specified. 


INDDname 





INDOname-7—(ddn) 
coal 


ddn 
specifies the name of the DD statement that identifies the (input) dump data set.’ 
This data set can be on a tape or DASD volume. 


LOGicalvolume 





LOGICALVolume ie mi 


LYOL 





specifies. for a physical data set RESTORE operation, the volume serial number(s) 
of the source DASD volume(s) that are to be processed. For example, if you have 
taken a data set dump from volumes 111111, 222222, and so forth, but you want to 
restore only some data sets from source volume 222222, specify 
LOGICALVOLUME (222222). LOGICALVOLUME is useful for restoring multi- 
volume data sets. 


Latent: ty (model | 
VOlser(volser) 


specifies a model entity and, optionally, the serial number of the volume containing 
that entity (volser) to be used when DFDSS defines discrete profiles. These 
keywords are used to define the data sets to RACF. Specification of MVOLSER is 
optional when the model entity (MENTITY) is either (1) cataloged in an integrated 
catalog facility catalog or (2) a non-VSAM data set cataloged in the standard 
catalog search order. When MVOLSER is specified for a VSAM model entity, the 
volser specified must be the volume serial number of the catalog in which the model 
entity is cataloged. If these keywords are not specified, DFDSS defines the data set 
to RACF without using a model. 


MENtity 


During a RESTORE operation, DFDSS defines a data set to RACF only if: 


¢ The data set was RACF-protected with a discrete profile during DIJMP 
e Either the data set is not preallocated or it is preallocated but not 
RACF-protected with a discrete profile. 


For a description of RACF data sets, refer to Resource Access Control Facility 
(RACF) General Information Manual. 
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GMTCLAS (management—class—name) 
NULLMGMTCLAS 
MC. 


specifies the user-desired management class that is to replace the source management 
class as input to the ACS routines. You must have the proper RACF authority for 
the management class specified. The keyword itself does not require RACF authori- 
zation. 


NULLMGMTCLAS specifies that the input to the ACS routines is to be a null 
management class rather than the source data set’s management class. 


MGMTCLAS and NULLMGMTCLAS are mutually exclusive. 


Note: All SMS-managed data sets specified in the BYPASSACS keyword will be 
assigned the specified management class because the ACS routines will not be 
invoked. Non-SMS-managed data sets do not have a management class. 


Le Hal] 


specifies that DFDSS is to allocate the target partitioned data set only to devices 
that are the same or like device type as the source, and that DFDSS is to use track 
level I/O to perform data movement. This results in an exact track-for-track image 
of the source data set on the target volume. 


dsn 
specifies the fully- or partially-qualified name(s) of a PDS to be processed. 


NOPACKing is only valid with a PDS. If REBLOCK is specified, REBLOCK is 
ignored for the data set. 


A PDS restored using NOPACKing is not compressed during data movement. 
NOPACKing can be used for a damaged PDS that is currently usable by an applica- 
tion but would be made unusable by compression or other rearrangement of the 
physical layout of the data. 


e 
scRERSae eT is ) 
0D 





ddn 

specifies the name of the DD statement that identifies a volume to be restored. To 

assure correct processing, each of the DD statements corresponding to a DDNAME 
(ddn) must identify only one volser. For a logical data set RESTORE or when you 
specify spill files, you can specify multiple names, separated by commas. 
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specifies tnat the volume to be restored is to be dynamically allocated. If real (not 
virtual), the volume must be mounted and online. For a logical data set RESTORE 


or when you specify spill files, one or more volumes are allowed. 


OUTTRacks 


PASsword 
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volser 

specifies the volume serial number of a DASD volume to be restored. 

unit 

specifies the device type of a DASD volume to be restored. This keyword is 
optional. 


Note: OUTDDNAME or OUTDYNAM is required for restoring from a physical 
dump and optional for restoring from a logical dump. They are optional for a 
logical RESTORE, except: 


¢ For multivolume data sets that are preallocated on volumes that are different 
from the original source volumes; or 
e When the original source volume is not available. 


—_ le | i I 


sc ec 
—aurTRKs— hd 


specifies. Sor a track RESTORE, the beginning location of the cylinder and head 
number c: the target volume to which the track is to be restored. 


If OUTTRKS is not specified, the track is restored to its original cylinder and head 
number. 





ésinane 


/pswd 


specifies <he passwords DFDSS is to use for password-protected data sets for all 
RESTORE operations. (Password checking is bypassed for RACF-protected data 
sets.) This is required only if: 


e You do not have the required volume-level RACF DASDVOL or RACF 
DATASET access. 

¢ The installation authorization exit does not bypass the checks. 

¢ You do not want to be prompted for the password. 


ddn 

specifies the name of the DD statement that identifies the sequential data set, or 
member of a partitioned data set, that contains data set names and their passwords 
in the format dsn/pswd[,...]. This data set must contain card-image records in 
DFDSS command syntax format. 


PERCENTUtilized 


PROCESS 


REBLock 


dsn|pswd 
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dsn is a fully- or partially-qualified data set name. pswd is its password. If no pass- 
word follows the slash (/), dsn is treated as though it were ddn. 


catname|pswd 
catname is a fully-qualified catalog data set name. pswd is its password. This is 
supported for VSAM data sets only. 


Note: - Printing of actual data set passwords specified in your input command stream | 
is suppressed in the SYSPRINT output. 





eae li ae | 


specifies that DFDSS must stop allocating data sets to the target volume(s) when the 
allocated space reaches n percent of the total space on the target volume. The 
default is 100. Specify more than one n if you have more than one target volume 
(for instance, a volume for overflow). PERCENTUTILIZED is ignored When the 
target data set is preallocated. 


Note: PERCENTUTILIZED is not supported in an SMS environment. This 
keyword is valid only for logical data set restore operations. 


roe (UNDEF i settee cl 


specifies that the logical data set RESTORE operation is to be allowed for undefined 
DSORG data sets going to an unlike target device of a larger capacity and that 
DFDSS is to use track level I/O to perform data movement. This results in an exact 
track-for-track image of the source data set on target volume. 


LPurce 
PRG 


specifies that a full or tracks RESTORE is not to be stopped if there are unexpired 
data sets on the target volume. See the REPLACE keyword for a data set 
RESTORE. 


eeu 


specifies that DFDSS is to reblock one or more of the selected SAM or PAM data 
sets unless otherwise overridden by the user reblock exit routine. 


dsn 
specifies the fully- or partially-qualified name(s) of a SAM or PAM data set to be 
copied and reblocked. 


The following data sets are not eligible for reblocking: 


¢ PAM data sets with NOTE lists and load modules 
« SAM and PAM data sets with RECFM = U,RECFM = variable spanned. 
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(pfx) 


(pfx), aa 


specifies that, if a data set with the old name exists on the output DASD volume, 
DFDSS is to allocate a new data set with the new name and restore the data set. If 
the data set with the old name does not exist on the volume, the data set is restored 
with the old name. For a VSAM data set that already exists on another DASD 
volume and is cataloged, the VSAM data set is restored with the new name unless 
the new name also exists and is cataloged. 






For a physical data set RESTORE, RENAME is not supported for VSAM data sets. 
This keyword only applies to movable data sets, therefore, unmovable or ISAM data 
sets will not be renamed. See “Special Considerations for Restore” on page 117 for 
details. RENAME and RENAMEUNCONDITIONAL are mutually exclusive; you 
cannot specify these keywords together. 


pfx 

Specifies the prefix to be used to replace the first-level qualifier of the data set name. 
It is optional, but if specified, must be the first parameter in the list of subkeywords. 
The prefix is used only if the (on,nn) parameters are not specified or the old name 
filters do not match the data set name. 


on 
Specifies the old name to be used as filtering criteria for matching data set names on 
the target volume. . 


nn 
Specifies the new name to be used to derive the new data set name if the data set 
name selected by the corresponding old name filtering criteria matches the name of a 
data set that already exists on the target volume. 


If none of the old name filters match the data set name and the prefix is specified, 
the prefix is used to derive the new name. If old name filters do not match and the 
prefix is not specified, the data set is not restored. If the old name filter matches 
and there is an error in the new name filter, the data set is not restored. 


The syntax for the prefix is as follows: 


e Single-level, fully-qualified, unquoted DSNAME 

* 8 characters or less 

¢ The first character should be an alphabetic character 
¢ The rest of the characters can be alphanumeric. 


The syntax for the old name filter is exactly like that of the INCLUDE filter, and 
their rules match. For more information, see the INCLUDE keyword for the 
RESTORE command, or see “Filtering by Data Set Names” on page 10. 


Examples of valid syntax for the new name filter are: 


e **—Restore the data set with the old name. This provides a powerful tool 
whereby some data sets can be restored with the old name and others can be 
restored with the new name. 


e *—If DSNAME has one level, then restore with old name. 


-»RESTORE Command “*""” 


"—s-A.**First level of DSNAME replaced by A. : 
¢ A.B.**—First two levels of DSNAME replaced by “A.B”. 
e *,A.**—Second level of DSNAME replaced by A. 
e **,.BCD—Last level of DSNAME replaced by BCD. 
e DATE.**.LIST—First and last levels are replaced by DATE and LIST. 
° Q.*—If DSNAME has two levels, replace the first by Q. 
e Q.*.8—-If DSNAME has three levels, replace the first and last by Q and B. 
e *,*, SYSLIST—If DSNAME has three levels, replace the last by SYSLIST. 
e ABC.DEF—No asterisk in substring; replace the entire name with “ABC.DEF”. 


Examples of invalid syntax for the new name filter are: 
e ** DATA.**—Invalid (level to be replaced is ambiguous). 
¢ *SYS*—Invalid (a qualifier is not completely replaced). 
e SYS*—Invalid (a qualifier is not completely replaced). 
e¢ *SYS—Invalid (a qualifier is not completely replaced). 
* SYS*TEM—Invalid (a qualifier is not completely replaced). 
If the new name filter has errors, the data set is not restored. The new name that is 


derived is truncated to fit 44 characters. If it ends with a period, that period is also 
truncated. 


If the new name is not fully qualified, then it must contain the same number of qual- 
ifiers as the old name. For example, given the old name filter DATE.** and the new 
name filter DATE.*.*.LIST, DATE.MARCH. TODAY.OLDLIST would be renamed, but 
DATE.MARCH.OLDLIST would not. 


RENAMEUnconditional 










den 
ae ee 


specifies that the data set should be restored with the new name, whether or not the 
data set exists on DASD with the old name. If the data set exists on the volume 
with the new name, it is not restored. This keyword only applies to movable data 
sets, therefore, unmovable or ISAM data sets will not be renamed. If the old name 
filter matches and there is an error in the new name filter, the data set is not 
restored. See “Special Considerations for Restore” on page 117 for details. 


RENAMEUnconditi ea ee 
RENUNC 


Notes: 


1. RENAME and RENAMEUNCONDITIONAL are mutually exclusive; you 
cannot specify these keywords together. RENAMEUNCONDITIONAL is not 
supported for physical restore of VSAM data sets. 


2. RENAMEUNCONDITIONAL specifies that the data set must be restored with 
the new name, regardless of whether the data set exists on DASD with the old 
name. If the data set exists on the target volume with the new name, an allo- 
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cation error occurs and the data set is not restored, regardless of whether 
REPLACE is specified. 


pfx 

specifies the prefix used to replace the first-level qualifier of the data set name. It is 
optional but, if specified, must be the first parameter in the list of subkeywords. The 
prefix is used only if the (on,nn) parameters are not specified or the old name filters 
do not match the data set name. 


on 
Specifies the old name to be used as a filtering criterion to check if it matches the: 
data set name. 


nn 
Specifies the new name to be used to derive the new data set name if the data set 
name matches the corresponding old name filtering criterion. 


For syntax rules, see the discussion of pfx, on, and nn under “REName” on 
page 112. 


Lepr | 


specifies that if the data set exists on DASD, it can be replaced with the data set 
from the source volume. DFDSS searches the output volumes for preallocated data 
sets. If no output volumes are specified, DFDSS. searches the volumes on which the 
data set resided at dump time. If no preallocated target is found, DFDSS attempts 
to allocate a data set. If allocation is successful, the data set is restored. PURGE is 
accepted and is treated the same as REPLACE. 


For non-VSAM data sets, if the target data set is smaller than the source data set, 
DFDSS scratches the target data set and reallocates it with the size of the source 
data set. 


Notes: 


1. REPLACE must be specified to restore preallocated unmovable data sets. 


2. REPLACE is required for movable data sets if a preallocated data set is to be 
replaced. 


3. If REPLACE is specified with RESTORE, the classes already associated with 
the preallocated data set remain the same. See “Special Considerations for 
Restore” on page 117 for more information. 


stare 
SHR 
specifies that DFDSS is to share, for read access with other programs, the data sets 


that are to be restored. The resetting function is bypassed if SHARE is specified on 
a data set RESTORE. 


SHARE and FULL are mutually exclusive; you cannot specify these keywords 
together. 


“RESTORE Comniand * ** 


SPHERE 
Lspuere— 


specifies that for any VSAM cluster dumped with the SPHERE keyword, DFDSS 
must also restore all associated AIX clusters and paths. Individual sphere compo- 
nent names need not be specified; only the base cluster name is required. 


STORCLAS (storage—class—name) 
NULLSTORCLAS 
NSC 


specifies the user-desired storage class that is to replace the source storage class as 
input to the ACS routines. The user must have the proper RACF authorization for 
the storage class specified. The keyword itself does not require authorization. 


STORCLAS 


NULLSTORCLAS specifies that the input to the ACS routines is to be a null 
storage class rather than the source data set’s storage class. 


STORCLAS and NULLSTORCLAS are mutually exclusive. 


Note: If BYPASSACS(dsn) is specified, all data sets that pass the BYPASSACS 
selection criteria are guaranteed the specified storage class. The combination of 
NULLSTORCLAS and BYPASSACS(dsn) forces the selected data sets to be 
non-SMS managed. 


TRACKS 


: cae 


| | 
Tins Me 
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specifies ranges of tracks to be restored (that is, a tracks RESTORE). If any of the 
requested tracks are not in the input file, the RESTORE operation is stopped. 


cl,hl 
specifies the cylinder and head number of the beginning of the range. Specify 
hexadecimal numbers as X‘cl' or X'hlI'. 


c2,h2 
specifies the cylinder and head number of the end of the range. Specify hexadecimal 
numbers as X'c2' or X'h2'. 


Notes: 

1. The c2 must be greater than or equal to cl. 

2. If c2 equals cl, h2 must be greater than or equal to hl. 
DFDSS verifies that the range is within the limits of the device. If you do not 
specify all four values for a range, DFDSS provides the missing values unless the 


omitted value causes a syntax error. No intervening values can be omitted. For 
example: 


Specified Results 


None Syntax error 
cl c1,0,cl,maximum head number 
cl ,hl cl,hl,cl,maximum head number 


cl,hl,c2 — cl,hl,c2,maximum head number 
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cl,,c2 Syntax error 
Al Syntax error 





TGTA? 1oc—(—-BLK ) 
CYL 
TRK: 
SOURCE 
SRC: 
specifies, during a logical data set RESTORE, how DFDSS will allocate the target 
data set. 


BLK 
specifies to allocate by blocks. 


CYL 
specifies to allocate by cylinders. 


TRK 
specifies to allocate by tracks. 


SOURCE/SRC ; ; . 
specifies to allocate with the same space allocation type as that of the source data 
set. 


Notes: 


1. If the TGTALLOC keyword is omitted, the target allocation defaults to source. . 
. If BLK is specified for VSAM data sets, TRK is used instead. The final VSAM 
allocation can be different from the requested one because of VSAM allocation 

rules. 


i) 





specifies in what status, during a data set operation, that DFDSS is to place non- 
preallocated SMS-managed GDG data sets: 


DEFERRED 
specifies that the target data set is to be assigned the DEFERRED status. 


ACTIVE 
specifies that the target data set is to be assigned the ACTIVE status, for example, 
rolled into the GDG base. 


ROLLEDOFF 
specifies that the target data set is to be assigned the rolled-off status. 


SOURCE/SRC 
specifies that the target data set is to be assigned the same status as that of the 
source data set. 


Note: The requested target status of generation data sets must not violate gener- 
ation data group rules. 


| TOLerate 
LroLerate—(ENQFai ] ee es 

ENQFailure 

specifies that data sets are to be processed even though shared or exclusive access 


fails. TOL(ENQF) and FULL are mutually exclusive; you cannot specify these 
keywords together. 


For more information on TOL(ENQF), see Appendix B, “Serialization and Authori- 
zation Checking” on page 165. 


WAIT 


Laat ntmsees snumretri es 


specifies to DFDSS the length of a wait in seconds and the number of retries to 
obtain control of a volume or data set. 


numsecs 
is a number from | to 255 that specifies the time interval, in seconds, between 
retries. 


numretries 
is a l- or 2-digit number that specifies the number of times an attempt to gain 
control of a volume or data set is to be retried. 


The default for numsec,numretries is (2,2), which specifies two retries at 2-second 
intervals. If you do not want to wait for a resource, specify 0 for either numsecs or 
numretries. 


Fewat techeck- 
RC 


specifies that the data restored is to be verified for successful completion. This 
keyword increases the overall elapsed time. The default is no WRITECHECK. 


WRitecheck 


Special Considerations for Restore 
The actions DFDSS performs for RENAME, RENAMEUNCONDITIONAL, or 
REPLACE depend on the keywords you specify and the configurations of data sets 
on volumes. This section contains figures that describe specific environments for 
DFDSS RESTORE operations. 


Figure 7 on page 118 describes, in decision table format, DFDSS RESTORE 
actions for physical processing of SMS-managed data sets. The specified RESTORE 
keywords and the existence of the data set are shown in the upper half. The actions 
taken are shown in the lower half. 


Figure 8 on page 119 describes general DFDSS actions for both physical and logical 


RESTORE on non-VSAM data sets. It is not a program flowchart. Use it to clarify 
the RESTORE actions on non-VSAM data sets under varying conditions. 


Chapter 3. Syntax—Function Commands 117 


BO ke ge em aa dba Mgr g De 2g Me ed mind ot — 
“RESTORE Command oi : : 


RENAME NNYYYY----—-NN 


RENUNC NN-~---YYYYNN 


REPLACE LY YNNYYNNYYNN 


OLD DATA SET EXISTS | YNYNYNYNYNYN 
NEW NAME ON USERVOL 


NEW NAME ON VDSSVOL | ~--X-XNNNN-- 


Overlay old data set 
on USERVOL 


Overlay old data set 
on VDSSVOL 


ALLOC with old name 
on USERVOL & restore 


ALLOC with new name 
on USERVOL & restore 


ALLOC with old name 
on VDSSVOL & restore 


ALLOC with new name 
on VDSSVOL 


Do not restore 


Yes 
No 
Action taken 
Don't Care 
Not Applicable 
USERVOL Output volume specified in Restore command 
VDSSVOL Output volume selected by VTOC/Data Set Services 
Note: Once a target volume is selected based on the matrix above, 
all the selected data sets on the same input logical volume 
must be restored to the same target volume except that when 
certain errors occur, a message is issued and the data 
set is not restored. 





Figure 7. Physical Data Set Restore Actions on SMS-Managed Data Sets 
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Figure 8. RESTORE Actions on Non-VSAM Data Sets. These actions apply to a data set RESTORE with 
RENAME, RENAMEUNCONDITIONAL, and REPLACE keywords. 
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Assignment of Class Names by Using RESTORE and COPY 
In an SMS environment, you can use STORCLAS, MGMTCLAS, 
NULLSTORCLAS, NULLMGMTCLAS, and BYPASSACS keywords with 
RESTORE and COPY to influence the class names assigned to a data set. Figure 9 
shows how these keywords can influence the storage and management class names of 
the target data set in a RESTORE or COPY operation. 


Source 
data set 
classes 


MGMTCLAS 
STORCLAS 
NULLSTORCLAS 
and/or NULLMGMTCLAS 


User 
specified 
classes 


Source 
classes 


BYPASSACS 


ACS 
routines 
Target 


data set 
classes 


No classes 
assigned 


| 





Figure 9. DFDSS Target Class Selection 
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Notes to Figure 9 on page 120: 


¢ If you specify BYPASSACS, the source data set’s class names or the class names 
specified with STORCLAS and MGMTCLAS are assigned to the target data 
set. If you do not specify BYPASSACS, ACS uses the source data set’s class 
names, or the class names specified with STORCLAS and MGMTCLAS as 
input to assign the target data set’s class names. 


¢ If you specify NULLSTORCLAS, DFDSS passes a null storage class to ACS, 
which selects a storage class for the data set. If you specify NULLSTORCLAS 
and BYPASSACS together, the data set becomes non-SMS managed. 


¢ NULLMGMTCLAS can only be used with SMS-managed data sets. Specifying 
NULLMGMTCLAS and BYPASSACS together causes the removal of the ori- 
ginal management class of the data set. 


Data Integrity Considerations for Full or Tracks RESTORE 
For a full or tracks RESTORE, DFDSS serializes the VTOC to preclude DADSM 
functions such as ALLOCATE, EXTEND, RENAME, and SCRATCH from 
changing the contents of the VTOC on the volume during the RESTORE. Data sets 
are not serialized on these full or tracks operations. Therefore, some data sets might 
be opened by other jobs during the RESTORE. The result might be that partially 
updated data sets are restored. For mountable devices, you can minimize this possi- 
bility by doing the following: 


VOL=(PRIVATE, SER=xxxxxx) 


Full data integrity can always be guaranteed by performing RESTORE operations 
by data set only. 


Examples of Full and Tracks RESTORE Operations 


Example 1 shows that DASD volume 111111 is to be restored from the first data set 
of standard label tape volumes TAPEO! and TAPEO2. 


The command input to be substituted for a full and tracks RESTORE are shown 
below in Example 1A and 1B respectively. To dump the same volume, refer to 
Examples 1, IA, and 1B of the DUMP command. 


Example 1: 


//JOB1 JOB accounting information,REGION=nnnnk 
//STEPL EXEC PGM=ADRDSSU 
//SYSPRINT OD SYSOUT=A 
//TAPE DD UNIT=3480, VOL=SER=(TAPEO1, TAPEO2) , 
// \LABEL=(1,SL) ,DISP=(OLD,KEEP) ,DSNAME=USER2. BACKUP 
//DASD DD UNIT=3380, VOL=(PRIVATE, SER=111111) ,DISP=OLD 
//SYSIN DD * 
command input (see Examples 1A and 1B below) 
/* 


Example 1A: A Full RESTORE 
RESTORE INDDNAME(TAPE) OUTDDNAME(DASD) PURGE 


Example 1B: A Tracks RESTORE 


RESTORE TRACKS(1,0,1,5) INDDNAME(TAPE) - 
QUTDDNAME(DASD) PURGE 
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Example 1C: A Tracks RESTORE—Restore to Different Tracks 


//JOBTRKS JOB accounting information, REGION=nnnnKk 

//STEP1 EXEC PGM=ADRDSSU 

//TAPE DD UNIT=3480,VOL=SER=TAPEQ4, 

// LABEL=(1,SL) ,DISP=(OLD, KEEP) ,DSN=USER2.BACKUP 

//SYSPRINT DD SYSOQUT=A 

//SYSIN DD sOC* 

RESTORE INDD(TAPE) OUTDYNAM(338000) - 
TRKS(200,10,200,10) /* INPUT TRK 200,10 ON SOURCE VOL*/ - 
OUTTRKS (100,09) /*RESTORE TO 100,0 ON TARGET VOL */ - 
PURGE /* OK TO OVERLAY THE TRK */ - 

/* EVEN IF UNEXPIRED DATA SET AT THE LOCATION */ - 

PSWD(ABC/WRITPSWD) /* PASSWORD FOR THE DATA SET a 

Yh 


A track of dump data is restored to a cylinder and head number other than that 
from which it was dumped. The dump tape (which might have resulted from a full, 
tracks, or data set DUMP) contains a track dumped from cylinder 200 head 10 that 
is restored to cylinder 100 head 0. : 


Examples of Physical Data Set RESTORE Operations 


Example 2 specifies data sets on standard label tape volume TAPEO2 are to be 
restored to DASD volume 111111. 


Examples 2A through 2D below complement Examples 2A through 2G in “Exam- 
ples of Physical Data Set DUMP Operations” on page 80 in any combination. For 
example, the dump tape produced in Example 2C in “DUMP Command” can be 
used as the input tape for Example 2A below. © 


Example 2: 


//30B2 JOB accounting information, REGION=nnnnKk 

//STEPL EXEC PGM=ADRDSSU 

//SYSPRINT DD SYSOUT=A 

//TAPE DD UNIT=3480, VOL=SER=TAPEQ2, 

// LABEL=(1,SL),DISP=(OLD, KEEP) , DSNAME=USER2. BACKUP 

//DASD1 DD UNIT=3380, VOL=(PRIVATE, SER=111111) ,DISP=OLD 
//SYSIN DD me 

command input (see Examples 2A, 2B, ... below) 

* 


/ 


Examr!s 2A: Using the INCLUDE Subkeyword to Restore All Data Sets on a Dump 
Tape 


RESTORE INDDNAME(TAPE) OUTDDNAME(DASD1) - 
DATASET (INCLUDE (**) ) 


Example 2B: Using the INCLUDE and EXCLUDE Subkeywords 


RESTORE INDDNAME(TAPE) OUTDDNAME(DASD1) - 
DATASET (INCLUDE(**) - 
EXCLUDE(**.LIST)) 


All data sets with a final qualifier of LIST are restored. 


Example 2c: Using the INCLUDE, EXCLUDE, and BY Subkeywords 


RESTORE INDDNAME(TAPE) OUTDDNAME(DASD1) - 
DATASET (INCLUDE(**) - 
EXCLUDE(**.LIST) - 
BY ((EXPDT,LE,80045) ) ) 
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All data sets that satisfy the BY subkeyword except those specified in the 
EXCLUDE subkeyword are restored. 


Example 2D: With Filtering Data In a Data Set 


RESTORE INDDNAME(TAPE) OUTDDNAME(DASD1) - 
DATASET (FILTERDD(A1) ) 


Note to Example 2D: The following DD statement must be added to the JCL shown 
in Example 2: 


//Al 00 DSNAME=USER2.FILTER,DISP=SHR 


This cataloged data set (USER2.FILTER) contains three card-image records. The 
information shown below is positioned in columns 2 through 72 of each record: 


INCLUDE(**) - 
EXCLUDE(**.LIST) - 
BY ( (DSCHA,EQ,1)) 


Example 2E: Using the LOGICALVOLUME and REPLACE Keywords 


RESTORE INDDNAME(TAPE) OUTDDNAME(DASD1) - 
DATASET (INCLUDE(**)) LOGICALVOLUME(111111) - 
REPLACE 


Although the dump tape contains data sets from source volumes 111111 and 222222, 
only the data sets from source volume 111111 are restored. If movable or unmov- 
able data sets exist on the volume, you must replace the data sets. If no movable 
data sets exist on the volume, you must allocate the data set and restore. 


Example 2F: Using the REPLACE and RENAME Keywords 


RESTORE INDDNAME(TAPE) OUTDDNAME(DASD1) - 
DATASET (INCLUDE(**)) LOGICALVOLUME(111111) - 
REPLACE - 
RENAME ( (USER2) , (USER4.** ,USER3. **) ) 


In the above example, renaming takes place only for data sets that exist on DASD 
with the old name. Data sets with a first-level qualifier of USER4 are renamed to a 
first-level qualifier of USER3. The first-level qualifiers of all other data sets are 
replaced by USER2. Unmovable data sets are not renamed. 


Example 2G: Using the REPLACE and RENAMEUNCONDITIONAL Keywords 


RESTORE INDDNAME(TAPE) OUTDDNAME(DASD1) - 
DATASET(INCLUDE(**)) LOGICALVOLUME(111111) - 
REPLACE - 
RENAMEUNCONDITIONAL ( (USER2) , (*.PEAR.**,*.PLUM.**), - 
(MY .SPECIFIC.DS,YOUR.ANY) ) 


RENAMEUNCONDITIONAL is used for movable data sets; REPLACE is used 
for unmovable data sets. With the RENUNC keyword, movable data sets are 
renamed whether or not they exist on DASD with the old name. In the example, 
data sets with a second-level qualifier of PEAR are renamed by using a second-level 
qualifier of PLUM. MY.SPECIFIC.DS is renamed as YOUR.ANY. The first-level 
qualifier of all other movable data sets is changed to USER2. Unmovable data sets 
are not renamed. 
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Example 2H: RESTORE for All Data Sets 


RESTORE INDDNAME(TAPE) OUTDDNAME(DASD1) - 
WAIT (1,99) DATASET(INCLUDE(**) ) 


Example 2H shows you what to do if the data sets are in use for a short time 
interval during RESTORE. DFDSS waits for a second at a time and retries as 
many as 99 times if the data set is in use by another job. 


Example 2!: Restore Data Sets 


RESTORE INDDNAME(TAPE) OUTDDNAME(DASD1) - 
DATASET(INCLUDE(**)) TOL(ENQF) WAIT(0,0) 


In Example 2I, DFDSS tries to serialize (ENQ) each data set. If the ENQ fails, 
DFDSS does not wait (WAIT(0,0)), and the data set is processed without serializa- 
tion or enqueuing (TOL(ENQF)). 


Example 3: Using the RENAME Keyword to Restore a VSAM Data Set 


//30B3 JOB accounting information, REGION=nnnnk 
//STEP1 EXEC PGM=ADRDSSU 
//TAPE DD UNIT=3480, VOL=SER=TAPE04, 
// LABEL=(1,SL) ,DISP=(OLD, KEEP) ,DSN=USER3. BACKUP 
//SYSPRINT DD SYSQUT=A 
//SYSIN DD * 
RESTORE INDD(TAPE) OUTDYNAM(338000) 
DS(INCL(PARTS.VSAM1) ) 
RENAME (*. VSAM1,*. VSAM2) 
CATALOG 
PSWD (PARTS. VSAM1/MYPSWD) 
/* 


A VSAM key-sequenced data set, PARTS.VSAM1, is restored from a logical dump 
tape in this example. It is renamed as PARTS.VSAM2 and cataloged in the same 
catalog as PARTS.VSAM1. The cluster’s components, PARTS.VSAM1.DATA and 
PARTS.VSAM1.INDEX, are also renamed. 


Example 4: Using the RECATALOG Keyword 


//J3OB4 JOB accounting information, REGION=nnnnKk 
//STEPL EXEC PGM=ADRDSSU 
//TAPE DD UNIT=3480,VOL=SER=TAPEQ4, 
// LABEL=(1,SL) ,DISP=(OLD, KEEP) ,DSN=USER3. BACKUP 
//SYSPRINT DD SYSOQUT=A 
//SYSIN oD =«* 
RESTORE INDD(TAPE) OUTDYNAM( (338001) ,(338002)) - 


DS(INC(PARTS.**)) /* OR DS(INC(**)) wd - 
PCTU(80) - 
RECATALOG(USERCAT2) = - 
PSWD(USERCAT/MASTPSWD) /* PASSWORD OF THE CATALOG */ - 
TGTALLOC (SOURCE) 

/* 


In this example, data sets with a first-level qualifier of PARTS were dumped log- 
ically. All are restored to volume 338001 and cataloged in catalog USERCAT2. 
These data sets were on volume 338000 at the time of dump. Because the data sets 
may not fit on volume 338001, a spill volume, 338002, is specified. To ensure that 
the data sets on volume 338001 can be extended, 20% of the total space on volume 
338001 is to be left as free space (PCTU(80)). The password for the catalog is speci- 
fied instead of the password for each data set. TGTALLOC(SOURCE) specifies 
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that the data sets are to be restored with the same allocation type they had when 
they were dumped. 


Examples of Data Set RESTORE Logical Operations 
Example 1: A Logical Data Set RESTORE—Ouiput Voiumes not Specified 


//3OB5 JOB accounting information, REGION= annnk 
//STEP1 EXEC PGM=ADRDSSU - 
//TAPE DD UNIT=3480,VOL=SER=TAPEO4, 
// LABEL=(1,SL) ,DISP=(OLD,KEEP) ,DSN=USER3 . BACKUP 
//SYSPRINT OD SYSOUT=A 
//SYSIN DD: -.* 
RESTORE INDD(TAPE) - 
DS(INCL(USER1.MULTVOL)) - 
REPLACE 
/* 


In Example 1, data set USERI.MULTVOL is restored. The location to which it is 
to be restored is not given. This RESTORE statement also applies when the data set 
has been scratched inadvertently after the DUMP. A multivolume data set is 
restored to the volumes from which it was dumped, provided the data set is preallo- 
cated on the output volumes. If it is not preallocated, the data set is restored to the 
first volume from which it was dumped that has adequate space to restore the data 
set as a single-volume data set. 


The RESTORE statement can be modified as follows to support multiple restores of 
both single and multivolume data sets from dump tapes created by one of the above 


examples: 
//SYSIN DD * 

RESTGRE INDO(TAPE) /* RESTORE */ - 
OS (INI_(USERL.CNTL.**)) /* USER'S CONTROL DATA SETS */ - 
REPLACE /* OVERLAY DATA SETS IF THEY EXIST = */ 

/* 


Example 2: A Logical RESTORE of an Unmovable Data Set 


//J0B6 JOB accounting information,REGION=nnnnk 
//STEPL EXEC PGM=ADRDSSU 
//TAPE 9D ~=UNIT=3480 , VOL=SER=TAPEO4, 
// LABEL=(1,SL) ,DISP=(OLD, KEEP) ,DSN=USER4. 8ACKUP 
//SYSPRINT DD  SYSOUT=A 
//SYSIN DD «* 
RESTORE INDD(TAPE) OUTDYNAM(338000) - 
DS (INC (HIGH. PERF) ) - 
FORC= /* TO FORCE RESTORE OF UNMOVABLE DATA SET */ 
{= 


The unmovable data set, HIGH.PERF, does not exist on volume 338000. This data 
set existed on volume 338000 at the time of dump. The location, relative to the 
beginning of the volume. where this data set is to be restored is occupied by other 
data sets. The data set is marked as unmovable on volume 338000 because either: 


¢ You do not want DFHSM to move it to an unlike device type. 


* You do not want the data set to be relocated by DEFRAG for performance 
reasons. 


e It was allocated as an ABSTR data set for performance reasons. 
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Example 3: A Logical Data Set DUMP, Followed by a RESTORE to an Unlike 
Device 


//J0B1 JOB accounting information, REGION=nnnnK 
//STEP1 EXEC PGM=ADRDSSU 
//TAPE OD UNIT=3480,VOL=TAPEO1, 


// LABEL=(1,SL) ,DISP=(NEW,CATLG) ,DSNAME=USER2. BACKUP 
//SYSPRINT DD SYSOUT#A 
DUMP DATASET(INCL(USER2.0LDDS)) - 
OUTDD (TAPE) 
/* 


//30B2 JOB accounting information, REGION=nnnnKk 
//STEP1 EXEC PGM=ADRDSSU 
//SYSPRINT DD SYSOUT=A 


//TAPE DD UNIT=3480,VOL=TAPEO1, 
// LABEL=(1,SL) ,DISP=(OLD, KEEP) ,DSNAME=USER2. BACKUP 
//DASD DD UNIT=3380, VOL=(PRIVATE,SER=222222) ,DISP=OLD 


//SYSIN DD 6* 

RESTORE DATASET(  - 
INCLUDE(USER2.0LDDS) ) - 
INDDNAME(TAPE) - _ 
OUTDDNAME(DASD) - 

RENAME (*.OLDDS,*.NEWDS) 


- 
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In the first part of example 3, DFDSS dumps a cataloged data set (USER2.OLDDS) 
from a 3350 source volume to an IBM standard label dump tape (TAPEO1). Next, 
DFDSS restores USER2.OLDDS from TAPEO1 to a 3380 target volume (DASD 
volume 222222). The RENAME keyword is used to change the name of the data set 
to USER2.NEWDS. 


Example 4: DUMP/RESTORE for Converting to SMS 


//SYSPRINT 30 SYSQUT=* 

//DTAPEOl OD DISP=(,CATLG) ,DSN=¥338001.USER3.BACKUP, 
// LABEL=(1,SL) ,UNIT=3400-6, VOL=SER=TAPEO1 
//SYSIN DD: 


DUMP - 
DS{INC(**)) - 
LOGINDYNAM ( - 
(338001) - 
DELETE COMPRESS - 
CUTDDNAME (DTAPEQ1) 
/* 


This part of the example dumps all of the data sets on the non-SMS volume 338001 
to TAPEO! with the DELETE option. DELETE is required to avoid duplications in 
the RESTORE. 


//SYSPRINT OD SYSQUT=* 
//OTAPEOL 0D ODISP=(OLD,KEEP) ,DSN=V338001.USER3.BACKUP, 
// LABEL=(1,SL) ,UNIT=3400-6 , VOL=SER=TAPEO1 
FISYSIN. 9 - ODe 
RESTORE DS(INC(**)) - 

STORCLAS(SCO1MJA1) - 

INDDNAME (DTAPEOQ1) 
/* 


This second part of the example restores all of the data sets that were dumped in the 
first half of this example. Because no output volume is specified, most of the data 


sets will be allocated on SMS volumes throughout the system. The STORCLAS 
keyword indicates that the storage administrator wants the data sets to have a 
storage class of SCOIMJA1. The ACS routines might or might not assign the target 
data sets the storage class specified. All data sets not converted to SMS (ACS 
STORCLAS routine returns a null storage class) will be restored to the original 
volume. 
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Chapter 4. Syntax—Auxiliary Commands 


This chapter describes the following auxiliary commands you can use to further 
refine DFDSS processing: 


_Write-to-Operator (WTO) | 
‘SERIAL | 
PARALLEL 
SET. 


Write-to-Operator Command 


The WTO command lets you write a message to the system console. It can be used, 
for example, to allow the mounting of a required volume or to stop other jobs in the 
system before continuing processing of your DFDSS job. The message is limited to 

70 characters. The command syntax is: 


Pec Wi0 Messages ee 


The message that is issued as a result of using the WTO command will not be pre- 

fixed with a message ID by DFDSS. If you want a Renessaee ID, you must supply it 
- as part of the message text. 

One of the following routing codes will be assigned to the message: 

2 Master console information 


11 Programmer information 
The following descriptor code is assigned to the message: 
3. Event action required 


When a WTO command is encountered, DFDSS waits until the last-requested func- 
tion command completes before issuing the WTO command. 


Scheduling Tasks 
The following commands are useful for task scheduling activities: 


SERIAL 
PARALLEL 


The keywords PARALLEL and SERIAL can be truncated to PAR and SER, respec- 
uvely. No other auxiliary commands can be truncated. There are no alternative 
adbreviations for auxiliary commands. 


SERIAL Command 


The SERIAL command aliows you to re-initiate serial task scheduling (only one task 
at a time) after you have used PARALLEL task scheduling. Tasks are processed in 
the order in which they appear in the input stream. 
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If neither SERIAL nor PARALLEL has been issued, SERIAL is the default. The 
command syntax is: 


P>-SERi a] 


PARALLEL Command 


The PARALLEL command lets you initiate parallel task scheduling; that is, two or 
more tasks are processed concurrently, provided the required system resources (such . 
as virtual storage, DASD, or tape volumes) are available. The commands may not 
necessarily be processed in the order in which they appear in the input stream. The 
command syntax is: 


p>—PARAl |e) 


If a switch occurs from SERIAL to PARALLEL mode or vice versa, DFDSS waits 
for all previously scheduled tasks to be completed before continuing. If PAR- 
ALLEL is specified but required system resources are not available, some tasks may 
be delayed in processing until the resources are available (that is, when other tasks 
have ended). If DFDSS is operating in PARALLEL mode, an IF statement ensures 
that all prior commands are processed. 


Controlling Task Processing 


Condition Codes 


With the JF-THEN-ELSE-DO-END-SET-EOJ group of commands, you can direct 
DFDSS through a logical path in your command sequence, based on the condition 
(return) codes of previously completed operations. 


The condition codes that are tested in the IF-THEN-ELSE command sequence are: 


0 Indicates that the function was processed as directed and expected. Informa- 
tional messages mav have been issued. 


4 Indicates that some problem was encountered in processing the complete func- 
tion, but it was possible to continue. The continuation may not provide you 
with exactiv what vou wanted, but no permanent harm will have been done by 
such continuation. A warning message was issued. 


8 Indicates that a requested function did not process, began processing but ended 
prematurely, or the job ran without processing all requested functions. An error 
(E) message is issued. If an abend occurs in anv of the DFDSS subtasks, the 
return code is set to 8. 


12 Indicates that the job did not process. No functions were processed. 


16 Indicates that a function processed and left at least one volume or data set in an 
unusable condition. For example, a full volume DUMP ended prematurely, 
leaving the output tape in an unusable condition. 


The condition codes that are tested in the IF-THEN-ELSE command sequence and 
that can be set by the SET command cannot be passed from one job step to the 
next. However, the final maximum condition code is passed to the MVS system 
when DFDSS returns control to the system at the completion of step processing. 
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Setting Condition 


Codes 

With the SET command, you can set the LASTCC and MAXCC variables to any 
value from 0 to 16, inclusive. By doing this, you can influence the logical path 
DFDSS takes in the command sequence following the SET command. 


Caution: SET LASTCC should not be used before the first function command. 


The condition code of the last-requested operation (LASTCC) and the maximum 


‘SET Command 
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code of all completed operations (MAXCC) can be determined with an IF 
command. When an IF MAXCC or SET MAXCC command is encountered, 
DFDSS waits for all previously requested function commands to complete before the 
highest return code is determined. Also, when an IF LASTCC or SET LASTCC 
command is encountered, DFDSS waits for the /ast-requested function command to 
complete before the return code is determined. Following this, if the condition code 
is tested and satisfied, DFDSS ends the commands in the DO-END group or the 
single command that comes after the THEN keyword. If the tested condition is not 
satisfied, DFDSS bypasses the DO-END group or single command that comes after 
the THEN keyword. 


The syntax of the SET command is: 


>>—SET: ee ee 
LASTCC=numbe 
SET 
specifies that MAXCC or LASTCC is to be set to a new condition-code value. 


A SET command that occurs within an unprocessed THEN or ELSE clause is 
not processed. 


MAXCC 
specifies that the variable MAXCC is to be set to a new condition-code value. 
Setting MAXCC does not affect the value of LASTCC. 


LASTCC 
specifies that the variable LASTCC is to be set to a new condition-code value. 
If the value assigned to LASTCC is higher than the value of MAXCC, MAXCC 
is also set to the higher value. 


number 
specifies the value to be assigned to MAXCC or LASTCC. The maximum value 
that can be assigned is 16; a higher value is reduced to 16. 


Examples of Controlling Tasks for the SET Command: The examples that follow 
show the use of the SET command. 


Example 7: If you want to set the last condition code established to 12, specify: 
SET LASTCC=12 


Example 2: If you want to replace the highest condi-ion code established in proc- 
essing so far with 8. specify: 


SET MAXCC=8 


: Auxiliary Commands 


Using Condition Codes 


Condition codes are used to set up the IF-THEN-ELSE statements. LASTCC speci- 
fies a comparison to the last condition code and MAXCC specifies the maximum 
condition code for comparison. 


Using the IF-THEN-ELSE Command Sequence 


The syntax of the IF-THEN-ELSE command sequence is: 


>>I F LASTCC——op numbe THE command 
~ Caaxce— | DO—command set EN 


ESE = [omer 
DO0-—-command set———EN 





where: 


IF re 
specifies that a comparison is to be made, the outcome of which determines 
which logical path (in your command sequence) DFDSS is to take. 


LASTCC 
specifies that LASTCC (condition code of the last-requested operation) is to, be 
compared to a specified number. LASTCC is initialized to zero upon entry to 
DFDSS. 


MAXCC 
specifies that MAXCC (maximum condition code of all completed operations) is 
to be compared to a specified number. MAXCC is initialized to zero upon entry 
to DFDSS. 


op 
specifies an operator that describes the comparison to be made between the con- 
dition code specified by LASTCC or MAXCC and the number that follows the 
operator. This may be any one of six possible comparisons: 


EQ or = Equal to 

LE or <= Less than or equal to 
LT or <___Less than 

GT or > Greater than 

GE or >= Greater than or equal to 
NE or —= Not equal to. 


number 
specifies the decimal integer that is to be compared with MAXCC or LASTCC. 
Values greater than 16 are reduced to 16. 


THEN 
specifies that a single command or a group of commands (enclosed by DO and 
END) is to be processed if the tested condition is satisfied. THEN can be fol- 
lowed by another IF command. The ELSE clause can neither be on the same 
line as the THEN clause, nor can it be on the same line as the continuation of 
the THEN clause. 


ELSE 
specifies that a single command or a group of commands (enclosed by DO and 
END) is to be processed if the tested condition is not satisfied. ELSE can be 
followed by another IF command. 
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Nesting IF Commands: When an IF command appears in a THEN or an ELSE 
clause, it is called a nested IF command. The maximum level of allowed nesting is 
10, starting with the first time you specify IF. . 


Within a nest of IF commands, the innermost ELSE clause is associated with the 
innermost THEN clause, the next innermost ELSE clause with the next innermost 
THEN clause, and so on. If there is an IF command that does not require an ELSE 
clause, use a null ELSE clause (see “NULL Commands,” below), unless the nesting 
structure does not require one. If a nesting structure does not require a null ELSE 
clause, you will be told so by the DFDSS job stream. 


DO 
specifies that the group of commands that follow is to be treated as a single unit, 
that is, to be processed as a result of a single IF command. The set of com- 
mands is ended by END. A command following a DO must begin on a new 
line. 


END 
specifies the end of a set of commands initiated by the nearest unended DO. 
END must be on a line by itself. 


Examples of Controlling Task Processing for the IF-THEN-ELSE Command: The 
examples that follow show the use of the IF-THEN-ELSE command sequence. 


Example 1: In this example, nested IF commands are used to determine whether a 
COPYDUMP, EOJ, or PRINT command is to be processed. 


IF LASTCC > 4 - 

THEN IF MAXCC < 12 - 
THEN COPYDUMP ... 
ELSE £0d 

cLSE IF LASTCC = 4 - 
THEN 
ELSE PRINT a. 


This example specifies that, if the value of LASTCC is greater than 4, the value of 
MAXCC is to be tested. If the value of MAXCC is less than 12, the COPYDUMP 
command is processed, but if the value of MAXCC is 12 or greater, the EOJ 
command is processed instead. Again, if the value of LASTCC is 4 or less, 
LASTCC is tested for being exactly 4: No action is to be taken in this case. If, 
however, LASTCC is less than 4, the PRINT command is to be processed. 


Example 2: In this example, nested IF commands are used to determine whether a 
COPYDUMP or a PRINT command is to be processed. 
IF LASTCC > 4 - 
THEN IF MAXCC < 12 - 
THEN COPYDUMP ... 
ESE 
ELSE IF LASTCC = 4 - 
THEN PRINT ... 


Should the first IF command determine that LASTCC is greater than 4 and the 
second IF command determine that MAXCC is 12 or greater, no function command 
in the example is processed. The null ELSE command is used here to specify that 
the next ELSE is to correspond to the first THEN. 


Auxiliary Commands — 


Example 3: In this example, if the maximum condition code is zero, a 
COPYDUMP is to be processed and a data set is to be printed. 
IF MAXCC=Q - 
THEN DO 
COPYDUMP... 
PRINT: 35 
END 


Creating a Null Statement 
If THEN or ELSE is not followed by a continuation character or by a command on 
the same line, the THEN or ELSE results in a null command. The null command is 
used to specify that no action is to be taken if the IF clause is satisfied (a null 
THEN command) or if the IF clause is not satisfied (a null ELSE command). A 
semicolon after the THEN or ELSE keyword also results in a null command. 


If you want to specify a null THEN command, specify: 


TP tec DEN or LE gcues TENS 
ELSES x6 ELSE aes 


If you want to specify a null ELSE command, specify: 


Ue caw? TREN: aos or DP iow: THEN: acon 
ELSe ELSE} 


Common Continuation Errors 
The continuation rules, described in Chapter 1, “Specifying DFDSS Commands” on 
page 1, must be used carefully when auxiliary commands, comments, or blank 
records appear in your input. You must also be careful not to inadvertently specify 
a null clause when continuing auxiliary commands. 


The following examples show common continuation errors. 


Error Example 1: 


IF LASTCC = 0 - 
THEN 
PRE sae 


A continuation character (hyphen) is missing after THEN; consequently, a null 
THEN clause is assumed. The PRINT command is unconditionally processed. 


Error Example 2: 


IF LASTCo = 0 - 
THEN - 
COR TOON ne 
/* ALTERNATE PATH */ 
ELSE - 
PRINT .. 


Because no continuation character (hyphen) follows the comment, a null ELSE 
clause is assumed. ELSE is not matched with THEN, and an error message is 
issued. The PRINT command is ignored. Notice the correct use of the continuation 
character on the other lines. 
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Error Example 3: 


PRINT INDD( - /*COMMENT*/ 
DON1) 


The DDN! on the second line is ignored and nothing is printed because characters 
other than blanks appear after the continuation character (hyphen). 


Ending Your DFDSS Job 
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With the end-of-job (EOJ) command, you can end your DFDSS job after the cur- 
rently processing operation(s) or scheduled task(s) is completed. The command 
syntax is: 


~—E 0 et 


Stand-alone DFDSS Restore Program 


Chapter 5. Stand-alone DFDSS Restore Program 


This chapter describes how to use the stand-alone DFDSS restore program and pro- 
vides examples of job streams to run stand-alone DFDSS restore. 


You can use stand-alone DFDSS restore (ADRDMPRS) to perform either a full or 
a tracks restore from the first data set of DF DSS-produced dump tape(s) without the 
use of a system environment. Alternatively, you can run the stand-alone DFDSS 
restore program in a VM/370 virtual machine. ADRDMPRS operates in either 
ESA/370 mode, System/370 XA mode or System/370 mode. 


Compatibility with System DFDSS 


The dump format used by both the stand-alone DFDSS restore program and system 
DFDSS minimizes the time required for DUMP and RESTORE operations and 
facilitates the restoring of multiple data sets. Stand-alone DFDSS RESTORE can 
restore any physical dump made by DFDSS as long as the physical dump is the first 
data set on the tape volume. The dump tapes may contain standard user labels. 


Input and Output 
DFDSS uses as input: 
¢ Control statements 
¢ DFDSS-produced dump tape(s). 
DFDSS produces as output: 


e A restored direct-access volume 
* A message data set. 


Control Statements 


The stand-alone DFDSS restore program is controlled by using control statements. 
Because it is an independent program, operating-system job control statements are 
not used. 
DFDSS control statements consist of: 

¢ A JOB statement to begin your job. 

e A MSG statement to define an output device for operator messages. 


¢ A RESTORE statement to identify both the tape source volume (containing 
dumped data to be restored) and the DASD receiving volume. 


e An optional VDRL statement to specify the range of tracks to be restored. This 
is required for a tracks RESTORE only. 


¢ An END statement to end your job. 


The label on each statement is optional and, if specified, must start in column 1. If 
a label is not specified for any of the above statements, each such statement must be 
preceded by a blank character. 
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JOB Statement 


MSG Statement 


ey S le els a aoa hg dt he eg ee ey SES tiers eA te 


Control statements are coded as card images, and are contained in columns 1 
through 71. A statement that exceeds 71 characters must be continued on one or 
more additional card images. A nonblank character must be placed in column 72 to 
indicate continuation. A control statement can be interrupted either in column 71 or 
after any comma. The continued portion of the control statement must begin in 
column 16 of the following card image. 


The JOB statement indicates the beginning of a job. The syntax of the JOB state- 
ment is: 


JOB user-information-———---—--—>+ 
label 


JOB must be preceded and followed by at least one blank. If abel is specified, it 
must start in column |. 


_ The MSG statement defines the message data device. It follows the JOB statement 


and precedes the RESTORE statement. The syntax of the MSG statement is: 


ca eeramrermmeea NC) TODEY=xxxx, TCADDR=cuu--—_--_-__ > 


-1abel— 





where: 


MSG must be preceded and followed by at least one blank. If Jabel is specified, it 
must start in column 1. 


TODEV =xxxx 
specifies the tvpe of output device to receive messages. This can be specified 
generically or by a specific device type. Device types that can be specified are: 
¢ For consoie: CNSL (for console), 1052. 3210, 3215, 3270. or 3277 
Specify 1052 for the 3138, 3148, or 3158 console. Specify 3270 for the 3278 
Model 2A or 3036 console. Specify 3270 or CNSL only if it is the 
operator's console. If you have a console other than those listed, specifying 


CNSL may work. (See “Running the Stand-alone DFDSS Restore 
Program” on page 139.) 


¢ For printer: PRNT (for printer). 1403, 1443, 3211, 3262. or 3800 


Specify 3210 for the 3203 printer. Specify PRNT for the 4245 or 4248 
printer. 


* For tape: TAPE (for tape). 2400, 2420. 3400, or 3480. 


TOADDR = cuu 
specifies the channel number. c, and unit number. uu, of the message output 
device. 


RESTORE Statement 
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With a RESTORE operation, you can restore a subset of the tracks or all the tracks 
from a full volume dump tape(s) or from a tracks (one or more track ranges) dump 
tape(s). (For information on restoring a track or tracks from a physical data set 
dump tape. see “VDRL Statement” on page 138.) 


Stand-alone DFDSS Restore Program 


With the RESTORE statement, you specify both the tape source volume (containing 
dumped data to be restored) and the DASD receiving volume. The syntax of the 
RESTORE statement is: 


cca Pea a) »FROMADDR=cuu——_——— > 
Tabel 


a Naa a ae OE (aa 
»MODEL= 


where: 


RESTORE must be preceded and followed by at least one blank. If /abel is speci- 
fied, it must start in column 1. 


FROMDEV = xxxx 
specifies the type of the source device; for example, 2400. Eligible device names 
are 2400, 2420, 3400, 3424, 3430, 3480, and TAPE. (To use a 3430, specify 
either 3430 or TAPE. To use a 3480, specify 3480 or TAPE.) 


Note: The IBM 3424 Magnetic Tape Device is used for Brazil only. It isa 
rack-mounted tape unit that uses 0.5-inch tape on 10.5-inch reels; and writes 
data in densities of either 1600 or 6250 bits per inch. 


FROMADDR = cuu 
specifies the channel number, c, and unit number, uu, of the source device. 


TODEV = xxxx 
specifies the type of the receiving device; for example, 3380. This device type 
must be the same as the device type of the volume originally dumped. Eligible 
devices are: 3330, 3330-1, 2305 (or 2305-2), 3340, 3350, 3375, and 3380 (3344 is 
specified as 3340). 


TOADDR = cuu 
specifies the channel number, c, and unit number, uu, of the receiving device. 


VOLID = volser 
specifies the volume serial number of the receiving volume. If volser does not 
match the volume serial number found on the receiving volume, the operator is 
notified and the job is ended. 


MODEL =n 
specifies a decimal model number (2) for a 2305. If MODEL is omitted and 
TODEV = 2305 is specified, 2305-2 is assumed. 


Restore time can be minimized by selecting devices assigned to different channels. 
For example: 


cal. Cor. 
16 72 
RESTORE FROMDEV=2400 , FROMADDR=282, TODEV=3380, C 


TOADDR=190, VOLID=111111 


Note: The continuation symbol must appear in column 72 and the next line of text 
must start in column 16. 
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VDRL Statement 


The optional volume restore limits (VDRL) statement is used to specify the upper 
and lower limits of a tracks RESTORE. When the VDRL statement is used, it must 
be preceded by a RESTORE statement and must be followed by an END statement. 
The upper and lower limits you specify can encompass a subset of the tracks or all 
of the tracks from the following: 


¢ A full volume dump. If you omit VDRL, you restore the full volume. 

¢ A tracks (one or more track ranges) dump. You must specify VDRL in this 
case. 

¢ The first logical volume of a physical data set dump. You must specify VDRL 
in this case. 


The syntax of the VDRL statement is: 


>>——__— VDRL—— BEG IN=nnnnn 
—labei—— 
END=nnnnn 


where: 


VDRL must be preceded and followed by at least one blank. If /abel is specified, it 
must start in column |. 


BEGIN Soin 


END Statement 
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specifies a 1 to 5 decimal-digit relative track address (cylinder 0, track 0 = 0) of 
the first track to be restored. 


END =nnnnn 
specifies a | to 5 decimai-digit relative track address of the last track to be 
restored. If only one track is to be restored, this address is the same as that of 
the beginning address. If END is omitted, the last track of the volume, excluding 
those tracks reserved as alternates, is assumed to be the upper limit. 


Note: The BEGIN and END values can encompass two or more track ranges that 
have been dumped to tape, even though these values span tracks that were not actu- 
ally dumped. 


The END statement marks the end of a job. It appears after the VDRL statement 
(or RESTORE statement, if there is no VDRL statement). The syntax of the END 
statement ts: 


—label—— Bee ea 


END must oe preceded and followed by at least one blank. If label is specified, it 
must start in column 1. 
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Generic Device Names 
Generic device names can be used instead of non-DASD device names when one of 
the supported devices of that class is intended. For example, if an IBM 2520, 2540, 
2501, or 3505 Card Reader is to be used, the generic name CARD may be substi- 
tuted as follows in response to the ADRS505A DEFINE INPUT DEVICE message: 


INPUT=CARD , 00C 


Similarly, TAPE can be used for tape devices, PRNT for printer devices, and CNSL 
for consoles. 


Copying to Tape 


After DFDSS is installed and accepted by System Modification Program (SMP) or 
System Modification Program Extended (SMP/E) (as described in the Program 
Directory), the stand-alone DFDSS restore program resides in SYS1.SAMPLIB. 
The following sample job stream will copy the stand-alone DFDSS restore program 
to an unlabeled tape: 


//COPYSA JOB accounting information 

//STEPI EXEC PGM=IEBGENER 

//SYSPRINT DD SYSOUT=A 

//SYSIN DD DUMMY 

//SYSUT1 =D DSN=SYS1.SAMPLIB(ADRDMPRS) , DISP=SHR 
//SYSUT2 OD DSN=SAMPLIB,UNIT=3480,LABEL=(,NL), 
// DISP=(,KEEP) ,VOL=SER=nnnnnn, 

// OCB=(RECFM=F ,LRECL=80,BLKSIZE=80) 


Note: BLKSIZE=80 is required on the tape data set. 


Running the Stand-alone DFDSS Restore Program 


The stand-alone DFDSS restore program runs independently of the MVS system 
environment. It is not supported, however. by the IBM 3066 Console, which is only 
used with the IBM System,370 Model 168. 


The stand-alone DFDSS restore program must operate in EC mode. Therefore, 
before running the stand-alone DFDSS restore program under VM/370, you should 
enter: 


CP SET ECMCDE ON 


The stand-alone DFDSS restore program is loaded as card images on an unlabeled 
tape. Control statements can follow the last card image of the program or can be 
entered on a separate input device. The data to be restored must be on a tape 
mounted on a different tape drive. To run the stand-alone DFDSS restore program: 


|. Place the stand-alone DFDSS restore program deck in the reader or mount the 
tape reel that contains the program. Make the device ready. 


to 


. If the DFDSS control statements are to be read from a separate card reader or 
tape drive, make that device ready. 


3. Mount the input tape containing the data to be restored (later specified by the 
keyword FROMADDR =) and make it ready. 


4. Load the program from the reader or tape drive. (Follow the initial program 
load (IPL) procedure for the processor that will process the DFDSS program.) 
When the program is successfully loaded, the processor enters the wait state. 
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The rightmost 2 bytes of the program status word (PSW) of the IPLed processor 
contain the hexadecimal value FFFF. 


5. Define the control statement input device in one of the following ways: 


a. If a supported, channel-attached, operating console is available: 


1) 
2) 


Press the REQUEST or ENTER key of the console. 


In response to the message ADR505A DEFINE INPUT DEVICE, enter 
INPUT = xxxx,cuu where xxxx is device type, c is the channel address, 
and uu is the unit address. The device type can be 2400, 2420, 2501, 
2520, 2540, 3400, 3424, 3480, 3505, 3270, 1052, CNSL, CARD, or 
TAPE. . 


b. If a supported, channel-attached, operating console is not available: 


1) 


2) 


Follow the procedure to alter real storage for the processor and enter at 
storage location 0110 (hexadecimal): Ocuu (for example, X'000C0000' ) 
for 2540 or 3505 card readers; /cuu for 2501 or 2520 card readers; or 
2cuu for 2400 series or 3400 series 9-track tapes or 3480 Tape Subsys- 
tems. 


Cause an EXTERNAL INTERRUPT. Follow the procedure required 
by the processor to generate the external interrupt. Normally the inter- 


_ . rupt is generated by pressing a keyboard function key on the processor’s 


system console or pressing a button on the processor’s operator control 
panel. 


6. The control statements are now read from the specified device and the restore 
operation is started. Control statements are printed on the message output 


device. 


7. At the end of the job, END OF J0B is printed on the message output device and 
the processor enters a wait state. The processor’s PSW contains the hexadecimal 
value EEEE. 


8. When the dump file is on multiple tapes, the following message is issued at the 
end of each reel: 


ADRS61A 


END OF TAPE. MOUNT TAPE ON cuu. DEPRESS INTERRUPT KEY 


To continue the restore at this point, unload the current reel, mount. the next 
reel, ready the device, and cause an external interrupt. 
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WAIT State Codes 


Explanations of the programming status word (PSW) WAIT state codes follow. 

Code Explanation 

OOE2 WAIT state if a machine check occurs. 

1111 Temporary WAIT for completion of input/output. 

BCBC An attempt was made to IPL a processor that does not support EC 
mode. 

6666 WAIT for operator intervention. 


EEEE End WAIT state when the stand-alone DFDSS restore program has com- 
pleted the job. 

FFFF WAIT for operator input command. 

FFFFFF Error WAIT in IPL loader because one of the following bits is on in the 
CSW unit status: attention, status modifier, unit check, or unit exception. 
Register 3 contains the unit status/channel status of the CSW. 


_ Examples of Stand-alone DFDSS Restore Program Jobs 


You can use either IBM standard label or nonlabeled tapes as the source volumes 
for the stand-alone DFDSS restore program operation. 


Example ls A Full RESTORE Operation 


Example 2: 


Example 3: 


A full IBM 3380 DASD volume (serial number 111111) at address 150 is to be 
restored from IBM 3400 tapes at address 280. 


Co}. Col. Col. 
2 16 72 
JOB RESTORE 3380 FROM TAPE 

MSG TODEV=3210, TOADDR=009 

RESTORE FQOMDEY=3400 , FROMADDR=280 , TODEY=2280, C 


TOADDR=150,VOLID=Y1i111 
ENO 


A Tracks RESTORE Operation 


An IBM 3380 DASD volume (serial number 111111) at address 150 is to be partially 
restored from IBM 3480 tapes at address 280. 


Col. col. Col. 
2 i6 72 
JOB TRACKS RESTORE 33380 FROM TAPE 

MSG TODEY=3210, TOADDR=009 


RESTORE == ROMDEY=3480 , FROMADDR=280, TODE/=3280, C 
TOADDR=150 ,VOLID=111111 
VORL B8EGIN=20,END=219 


A Tracks RESTORE Operation Using Generic Device Names 


Col. Col. Col. ; 
2 16 72 

JOB TRACKS RESTORE 3380 FROM TAPE 

MSG TODEV=CNSL, TOADDR=009 


RESTORE FROMDEV=TAPE, FROMADDR=280, TODEV=3380, C 
TOADDR=150, VOLID=111111 

VORL BEGIN=20, END=219 

END 
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Storage Requirements 


The storage requirement, in bytes, to run the stand-alone DFDSS restore program is 
220K. . 
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Chapter 6. Customizing DFDSS and Its Interfaces 


This chapter explains how you can customize DFDSS by coding exit routines and 
tailoring Interactive Storage Management Facility (ISMF) panels. Product-sensitive 
programming interfaces are contained in this chapter. 


The installation exits described in this chapter are interfaces which are provided to 
allow the customer installation to perform tasks such as product tailoring, moni- 
toring, modification, or diagnosis. They are dependent on the detailed design or 
implementation of DFDSS. Such interfaces should be used only for these specialized 
purposes. Because of their dependencies on detailed design and implementation, it is 
to be expected that programs written to such interfaces may need to be changed in 
order to run with new releases or versions, or as a result of service. 


Coding Installation Exit Routines 
Installation exit routines supplied with DFDSS are: 


Installation Authorization Exit Routine 
forces authorization checking of protected data sets. 


Installation Enqueue Exit Routine © 
forces enqueuing of the VTOC for the duration of the full or tracks DUMP or 
COPY, or tracks PRINT, or, if TOLERATE(ENQFAILURE) is specified, for 
the duration of a data set DUMP. 


Installation Options Exit Routine 
does not override any default or user-specified command options in the input 
stream. 


Installation Reblock Exit Routine 
during a data set COPY or data set RESTORE, allows DFDSS to use the block 
size it selects for the target data set. 


For MVS/XA installations, all DFDSS exit routines must be link-edited with the 
ADRDSSU load module with AMODE=31 specified in the link-edit PARMs. 


Installation Authorization Exit Routine (ADRUPSWD) 
DFDSS supports authorization checking of password- and RACF-protected data 
sets and volumes. DFDSS provides an exit routine to enable you to control or over- 
ride the authorization checks (RACF, password, or operator) done by DFDSS. 


If the user is APF-authorized (the JSCBPASS bit is set) or has the proper level of 
RACF DASDVOL access authority, the ADRUPSWD exit is not called. For 
DEFRAG, if a RACF DASDVOL profile exists for the volume being processed, the 
ADRUPSWD exit is not called. If the DASDVOL profile exists at all, either it 
allows the volume to be accessed (in which case there is no need to call the exit) or it 
causes the DEFRAG task to fail with a 913 abend (in which case DFDSS cannot 
call the exit). Otherwise, the exit routine supplied with DFDSS causes DFDSS to: 


1. Not relocate protected data sets for which you do not have read access during 
DEFRAG. That is, you must supply a password for each protected data set. 


2. Check authorization at the data set level for all functions other than 
COPYDUMP. 
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If a data set is protected by using both RACF and a password, only RACF checking 
is done. Authorization for password-protected non-VSAM data sets is checked by 
comparing the user-supplied password to that in the PASSWORD data set. Author- 
ization for VSAM data sets is checked by using the VSAM catalog management ser- 
vices. Authorization for VSAM data sets not cataloged in the integrated catalog 
facility catalog is checked by opening (OPENJ) the data set for read or write. (This 
OPENJ will fail if the data set has more than 16 extents.) 


Some Suggestions for Using the Installation Authorization Exit 


One use of the installation authorization exit is to improve DFDSS performance. If 
you use this exit to bypass authorization checking, you reduce the amount of proc- 
essing DFDSS does and improve performance. However, you should carefully con- 
sider the trade-off between security and performance before you use this exit to 
improve performance. 


installation-Supplied Authorization Exit Routine 
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Your installation can supply an exit routine to bypass authorization checking for 
both non- VSAM and VSAM data sets. The name of the routine must be 
ADRUPSWD and be link-edited to the DFDSS load module ADRDSSU. It must 
be written in reentrant code. (This routine is not given control fora COPYDUMP | 
operation.) 


The routine is given control at two levels: the volume level and the data set level. -. 
(except for DEFRAG, which is given control at the volume level only). Control is 
always given at the volume level first. A description of the two levels follows. 


Volume Level: At this level, on DUMP, COPY, PRINT, and RESTORE, you can 
determine if the user is to be allowed to proceed with the specified function. During 
DEFRAG. vou can determine if protected data sets are to be relocated. 


Your installation authorization exit routine can do one of the following: 


1. End the operation. 
2. Request processing without authorization checking at the data set level. 
3, Request that the installation authorization exit be entered at the data set level. 


Data Set Level: The routine is given control at this level during DUMP, COPY, 
PRINT, RESTORE, COMPRESS, and RELEASE operations only if the authori- 
zation exit routine instructs DFDSS to check authorization at the data set level. 
However, the routine is not given control at this level during DEFRAG. At the 
data set level, you can do one of the following: 


End processing of the volume. 

End processing of the current data set. 

Bypass authorization checking of the current data set. 

. Have DFDSS check authorization for the current data set. 

Also. for 2, 3, and 4 above, you can specify whether the exit routine is to be 
entered for subsequent data sets. 
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ADRDSSU loads the following registers as input to ADRUPSWD: 
Register Content 


1 Pointer to a 4-word parameter list. 

13 Address of a 72-byte standard register save area. 

14 Return address. 

15 Address of ADRUPSWD. This register should be used to pass back a 
return code. 


Standard register save and restore conventions must be observed. 


The four word parameter list contains the following. You can use the ADRUPB 
mapping macro to map this parameter list. See Figure 11 on page 148. 


First word Pointer to the Format | DSCB for the protected non-VSAM data set 
or the cluster name for a VSAM data set to 0 for volume level entry. 

Second word Pointer to the catalog name. Set to 0 for volume level entry. 

Third word Pointer to the volume serial number. 

, Fourth word Flags that are set as follows: 


Byte 0 
Bit Meaning 
0 —_——s End of the parameter list. This is always set to 1. 

1 Set to 1 if read access is required on the volume. Set to 0 
if write access is required. 

2 Set to | for a DUMP operation. 

3 Set to | fora RESTORE operation. 

4 Set to 1 for a COPY operation. 

5 Set to | for a PRINT operation. 

6 Set to | fora DEFRAG operation. 

7 Set to | fora COMPRESS operation. 

Byte 1 

Bit Meaning 

0 Set to | for DEFRAG, PRINT, DUMP, or RESTORE for 
a data set operation. 

1 Set to 1 for a full volume DUMP. RESTORE, or COPY 
operation. | 

2 Set to 1 for a tracks DUMP, RESTORE, COPY. or 
PRINT operation. 

3 Set to 1 fora RELEASE operation. 

4to7 Reserved. 

Byte 2 

Bit Meaning 

0 Set to | for volume level entry. Set to 0 for data set level 
entry. 

1 If it is 1, it is entered fora VSAM data set cataloged under 


the integrated catalog facility. Cluster and catalog names 
are passed. If itis 0, and byte 2, bit 0 is also 0, it is 
entered at the data set level for all data sets except VSAM 
data sets. 


Byte 3 Reserved. 
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Your ADRUPSWD routine should issue a return code in register 15 to indicate the 
course of action for further processing by DFDSS. The return codes, in decimal, 
and their meanings are shown in Figure 10 on page 147. 


Note: The installation authorization exit routine supplied with DFDSS passes a 
return code of 12. 


The first time ADRUPSWD is entered, the DSNAME address is not passed, but the 
VOLSER address is passed. If you elect to check the passwords and have 
ADRDSSU return to you for each data set, then, on the next entry, the DINAME 
address is also passed. 


An example of how to link-edit your ADRUPSWD routine with DFDSS module 
ADRDSSU follows. This example assumes that ADRUPSWD is in USERLIB (a 
cataloged data set). 


/ /NAME JOB (user accounting information) 

// EXEC PGM=HEWL, 

// PARM='LIST,LET,NCAL,XREF,RENT,AC=1,AMODE=31' 
//SYSPRINT DD SYSOUT=A 

//SYSUT1 OD UNIT=SYSDA, SPACE=(CYL, (1)) 
//SYSLMOD DD DSN=SYS1.LINKLIB,DISP=OLD 

//USER DD DSN=USERLIB,DISP=SHR 

//SYSLIN DD ied 


... -INCLUDE .. . USER(ADRUPSWD) 


INCLUDE SYSLMOD (ADRDSSU) 
ENTRY ADRDSSU 
NAME ADRDSSU(R) 

/* 
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1. Volume level entry: All functions except COPYDUMP 


Return Code 

End 
processing | 
for volume? 

0 No 

8 No 

12 No 

20 Yes 


Meaning 


Data set level 


Should ADRUPSWD be 
entered at data set 


checks required? level? 


No 
Yes 
Yes 
N/A 


No 
Yes 
No 
N/A 


If a nonzero return code less than or equal to 12 is returned for DEFRAG, all data sets on the 
volume are to be checked for authorization; any nonzero return code greater than 12 ends 
the function; if any data sets are protected and you do not have DASDVOL authority a return code of 20 


will always end the function. 


For all other functions, the function is ended with message ADR402E-15 if a return code other than 


those listed above is returned by ADRUPSWD. 


2. Data set level entry: All functions except DEFRAG and COPYDUMP. - 


Return Code 
End 
processing 
for volume? 
0 No 
4 No 
8 No 
EZ No 
16 No 
20 Yes 


Note: N/A means not applicable. 


Meaning 


End 


processing of Checking Should ADRUPSWD 


data set? 


No 
No 
No 
No 
Yes 
N/A 


required? be entered again? 
No No 

No Yes 

Yes Yes 

Yes No 

N/A Yes 

N/A N/A 


Figure 10. Return Codes From the Installation Authorization Exit Routine 
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Offsets Type Length Name Description 
0 (0) CHARACTER 16 ADRUPB 
0 (0) ADDRESS 4 UPDSCBAD 0 IF UPIND ISA 1 


Fl DSCB ADDR IF BOTH UPIND 
AND UPVSMDAT ARE ZERO 
ADDR OF 44-BYTE CLUSTER 
NAME IF UPIND IS ZERO AND 
UPVSMDAT ISA 1 


(4) ADDRESS UPCATP ADDR OF 44 BYTE CATALOG 





NAME IF UPVSMDAT IS A 1 


8 (8) | ADDRESS . 4 UPUCBVSA UCB VOLSER ADDR 
12 (C) _‘ BITSTRING 1‘ UPFLGI FLAG BYTE |! 
hole Bates UPEOL END OF LIST INDICATOR, ALWAYS 1 
Hives caaes UPFRTO 1 = SOURCE VOL, 0 = DEST. VOL 
i aren UPDUMP 1 = DUMP FUNCTION 
oe eee -..  UPREST. .. «|. 1 = RESTOREFUNCTION. -- >. -- = 
: Socve Vai UPCOPY 1 = COPY FUNCTION 
edi ater UPPRINT i = PRINT FUNCTION 
ee UPDEFRAG 1 = DEFRAG FUNCTION 
aed tek) UPCOMPR 1 = COMPRESS FUNCTION 
13 (D) —_ BITSTRING 1 UPFLG2 FLAG BYTE 2 
lice. Seas UPDSN 1 = DATASET OPERATION 
Wc sare UPFULL | = FULL VOLUME OPERATION 
1 
I 


wou dod 


Sphad Neiavets UPPART PARTIAL VOLUME OPERATION 
ak cae UPRLSE RELEASE FUNCTION 
weses ADT * RESERVED 
I4 (E) BITSTRING 1 UPFLG3 FLAG BYTE 3 
Bitea “aveeeie UPIND 1 = VOLUME LEVEL CHECK 





0 = DATASET LEVEL CHECK 


here: wees UPVSMDAT 1 = CLUSTER AND CATALOG 


NAMES PASSED 


15 (F)  BITSTRING UPFLG4 FLAG BYTE 4 RESERVED 
16 (10) CHARACTER * 


FORCE WORD ALIGNMENT 





Figure 11. ADRUPB Mapping Macro 


148 DFDSS: Reference 


Name 


ADRUPB 
UPCATP 
UPCOMPR 
UPCOPY 
UPDEFRAG 
UPDSCBAD 
UPDSN 
UPDUMP 
UPEOL 
UPFLGI 
UPFLG2 
UPFLG3 
UPFLG4 
UPFRTO 
UPFULL 
UPIND 
UPPART 
UPPRINT 
UPREST 
UPRLSE 
UPUCBVSA 
UPVSMDAT 


Hex 
Offset 


MoAAANUDmIaANMIAANnDDSAANRaAc 
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Stract 
Level 
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installation Enqueue Exit Routine 


The installation enqueue exit routine supplied with DFDSS works as follows: 


¢ For a full or tracks COPY or DUMP, or tracks PRINT—enqueues the VTOC 
during the entire operation — : | 

¢ For a data set DUMP (where TOL(ENQF) is not specified—enqueues the VTOC 
only until the VTOC is processed 


e For a data set DUMP (where TOL(ENQF) is specified—enqueues the VTOC 
during the entire DUMP. 


Some Suggestions for Using the Installation Enqueue Exit 


You can use this exit to prevent DFDSS from doing enqueue processing. By not 
doing enqueue processing, you can both improve performance and decrease the 
chance of deadlock. However, you must carefully consider the trade-offs between 
data integrity and performance and reduced chance of deadlock. 


Installation-Supplied Enqueue Exit Routine 


You may want to access a volume while it is being dumped, either by another job 
under the control of a second initiator or by another processor in a shared DASD 
environment. If so, your installation can supply an exit routine for the above oper- 
ations that will cause the VTOC to be enqueued only until it is processed. 


The name of the routine must bb ADRUENQ and be link-edited with the DFDSS 
toad module ADRDSSU. The routine must be written in reentrant code. 


Note: The installation enqueue exit routine will have no effect on the DEFRAG, 
COPYDUMP, RESTORE. or data set PRINT commands. 
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DFDSS loads the following registers as input to ADRUENQ: 
Register Content 


1 Pointer to a 2-word parameter list. 

13 Pointer to a standard 18-word save area. 
14 Return address. 

15 ‘ ~ Address of ADRUENQ. -~ 


The two word parameter list contains the following. You can use the ADRUNQB 
mapping macro, see Figure 12 on page 151, to map this parameter list. 


The first word of the parameter list is a pointer to the volume serial field for the 
volume being dumped. The second word of the parameter list contains flags that are 
set as follows: 


Byte 0 

Bit Meaning 

0 End of the parameter list. This is always set to 1. 

1 - Reserved. _ . 

2 Set to 1 fora DUMP operation 

3 Reserved. 

4 -. ~ Set to 1 for a COPY operation.’ 

5 Set to 1 for a PRINT operation. 

6 Reserved. 

7 Reserved. 

Bvte 1 

Bit Meaning 

0 Set to | for a data set operation. 

1 Set to 1 for a full volume DUMP or COPY operation. 
2 Set to 1 for a tracks DUMP, COPY, or PRINT operation. 
3 to7 Reserved. 

Byte 2 

Bit Meaning 

0 Set to 1 if TOLERATE(ENQFAILURE) is used. 

1-7 Reserved. 


Byte 3 Reserved. 


Your ADRUENQ routine should issue a return code in register 15 to indicate the 
course of action for further processing by DFDSS. Standard register save and 
restore conventions must be observed. 


The return codes and their meanings are: 


Return Code Meaning 


0 Enqueue on the volume being dumped or copied for the duration of 
the operation. 
4 Enqueue on the volume being dumped or copied only for the dura- 


tion of VTOC access. 


~~” Customizing DFDSS 


An example of how to link-edit your ADRUENQ routine with DFDSS follows. 
This example assumes that module ADRUENQ is in USERLIB (a cataloged data 


set). 

/ /NAME JOB (user accounting information) 

// EXEC PGM=HEWL, 

// PARM='LIST,LET,NCAL,XREF,RENT,AC=1,AMODE=31' 
//SYSPRINT DD _‘SYSOUT=A 

//SYSUT1 0D _ UNIT=SYSDA, SPACE=(CYL, (1)) 
//SYSLMOD OD DSN=SYS1.LINKLIB,DISP=0LD 

//USER DD DSN=USERLIB,DISP=SHR 

//SYSLIN 3)8) * 


INCLUDE USER (ADRUENQ) 
INCLUDE SYSLMOD (ADRDSSU) 





ENTRY ADRDSSU 
NAME ADRDSSU(R) 
/* 
Length Name Description 

0 (0) CHARACTER 8 ADRUNQB 
0 (0) ADDRESS 4 UNUCBVSA UCB VOLSER ADDR 
4 (4) BITSTRING .- 1 UNFLGI1 FLAG BYTE 1 

rr UNEOL END OF LIST INDICATOR, ALWAYS | — 

shee. ake * RESERVED 

wipes Setwie UNDUMP 1 = DUMP FUNCTION 

Seek sewed ¢ RESERVED 

da... UNCOPY 1 = COPY FUNCTION 
SS 7 UNPRINT 1 = PRINT FUNCTION 

tie ceeds * RESERVED 
5 (5) BITSTRING 1 UNFLG2 FLAG BYTE 2 

Leese axes UNDSN 1 = DATASET OPERATION 

eles sa8 UNFULL 1 = FULL VOLUME OPERATION 

Ar ey UNPART 1 = PARTIAL VOLUME OPERATION 

--l 1111 : RESERVED 

6 (6) BITSTRING i UNFLG3 FLAG BYTE 2 

Lisi Saas UNTOLNQF 1 = DATASET OPERATION 
= (7) CHARACTER 1 * RESERVED 








Pe eee ee eA es eee eee eee ee 


Figure 12. ADRUNQB Mapping Macro 


Name Hex Struct 
Offset Level 
ADRUNQB 0 1 
UNCOPY 4 3 
UNDSN 5 3 
UNDUMP 4 3 
UNEOL 4 3 
UNFLG! 4 2 
UNFLG?2 § a] 
UNFLG3 6 2 
UNFULL 5 3 
UNPART 5 3 
UNPRINT 4 3 
UNTOLNQF 6 3 
UNUCBVSA 0 2 
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Installation Options Exit Routine 


The installation options exit routine can control the processing of tasks or change 
some of the defaults or specified options. It is given control initially when DFDSS is 
invoked and also before processing of each task. During initial entry, it can specify 
where the I/O and application interface buffers are to reside and it can also change 
the default SERIAL mode to PARALLEL. When entered for each task, the routine 


- can change the options, defaults, or values (as applicable) listed in Figure 13. 


When you are doing a DEFRAG, an extent of a protected data set is relocated and 
the old extent is cleared (written over with 0’s) for security. This adds time to the 
DEFRAG process. You can prevent the clearing of the old extent with the installa- 
tion options exit. 


The exit routine can force the DUMP function to end if a write error occurs on any 
of the output copies. This is done by setting bit UFOIACPY on. The default is to 


continue to produce as many error-free output copies as possible. 


The exit routine supplied with DFDSS does not change any defaults, options, or 


values. : 
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Item to be 
Changed 


ALLDATA(*)/no ALLDATA 
ALLEXCP/no ALLEXCP 

ALLMULTI/no ALLMULTI 

CATALOG/no CATALOG 

COMPRESS/no COMPRESS 
COPYVOLID/no COPYVOLID 

DELETE/no DELETE 

DYNALLOC/no DYNALLOC 

FORCE/no FORCE 

NULLMGMTCLAS/no NULLMGMTCLAS 
NULLSTORCLAS/no NULLSTORCLAS 
PROCESS(SYS1)/no PROCESS(SYS1) 
PROCESS(UNDEF)/no PROCESS(UNDEF) 
PURGE/no PURGE 

REPLACE/no REPLACE 

RACFLOG/no RACFLOG 

REBLOCK no REBLOCK 

RECATALOG ‘no RECATALOG 

RESET/no RESET 











SERIAL/PARALLEL 
SPHERE/no SPHERE 


TOLERATE(ENQFAILURE)/no 
TOLERATE(ENQFAILURE) 


TGTALLOC/no TGTALLOC 


UNCATALOG ‘no UNCATALOG 


WRITBCHECS no WRITECHECK 


OPTIMIZE, FRAGMENTATIONINDEX, 
SHARE, and WAIT 











Figure 13. Task Alterations Made with Installation Options Exit 
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Change 


to no ALLDATA/ALLDATA(*) 
to no ALLEXCP/ALLEXCP 


. tono ALLMULTI/ALLMULTI . 


to no CATALOG/CATALOG 

to no COMPRESS/COMPRESS 

to no COPYVOLID/COPYVOLID 

to no DELETE/DELETE 

to no DYNALLOC/DYNALLOC 

to no FORCE/FORCE 

to no NULLMGMTCLAS/NULLMGMTCLAS 
to no NULLSTORCLAS/NULLSTORCLAS 

to no PROCESS(SYS1)/PROCESS(SYS1) 

to no PROCESS(UNDEF)/PROCESS(UNDEF) 
tono PURGE/PURGE 

to no REPLACE/REPLACE 

to no RACFLOG/RACFLOG 

to no REBLOCK/REBLOCK 

to no RECATALOG/RECATALOG 

to no RESET/RESET 

to PARALLEL/SERIAL 

to no SPHERE/SPHERE 


to no 
TOLERATE(ENQFAILURE)/TOLERATE(ENQOFAILURE) 


to no TGTALLOC/TGTALLOC 
to no UNCATALOG/UNCATALOG 
to no WRITECHECK/WRITECHECK 


Count values 





Some Suggestions for Using the Installation Options Exit 
You can use this exit to inhibit DFDSS functions. You can then force the use of 


your Own options and controls. 
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Installation-Supplied Installation Options Exit Routine 


Your installation can supply an exit routine to override certain defaults and user- 
specified parameters in DFDSS commands. The name of the routine must be 
ADRUIXIT and it must be link-edited with the DFDSS load module ADRDSSU. 


It must be written in reentrant code. 


. DFDSS loads the following registers as input to ADRUIXIT: 


Register Content 


1 Pointer to a parameter list, illustrated in the ADRUFO data area below. 

13 Pointer to a standard 18-word save area. 

14 Return address. 

15 Address of ADRUIXIT. This register is also used by you to pass back a 
return code. 


Registers 2 through 13 must be returned unchanged. 


The return codes, in hexadecimal, and their meanings are: 


Return Code Meaning 


No changes were made by this exit routine. 


0 
Awe < The parameter list has been modified. — 
8 


154 DFDSS: Reference 


Do not schedule this function (valid only for function command 
entry). 


This exit is entered for the following reasons only, during processing of DFDSS: 


During program initialization. This is called the PARM change entry. (The 
UFFUNCT field contains all zeros.) 


Just before scheduling a function command. This is called the function entry. 
(The function type is indicated by the UFFUNCT field.) 


You can use the ADRUFO mapping macro, see Figure 14 on page 155, to map the 
parameter list. The parameter list consists of the following sections: 


UFOHDR 
contains information describing the type of entry and, for a function entry, 
details of the function to be scheduled. It also contains an offset to 
Li vFUNCT or UFOPARM and the addresses of UFOVOL for input and 
UFOVOL for output. 


UFOFUNCT 
contains information about the function to be scheduled and which can be 
altered by this exit routine. The bits are described in the parameter list. It is 
created for the function entry. 


UCFOPARM 
contains bits that can be set to change defaults or override commands. The bits 
are described in the parameter list. It is created for the PARM change entry. 


LFOVOL 
is an array of entries describing the volumes used for input and output for the 
specific function commands. 


Figure 14 (Page 1 of 3). ADRUFO Mapping Macro 


Offsets 


Type Length 


Name 
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Description 











ANWAAHLOOS 


— 


— 
an 


19 


(0) 
(0) 
(0) 
(4) 
(6) 
(8) 
(C) 
(10) 


(10) 


dy) 


(12) 


(13) 


(14) 
(0) 


(0) 


(h) 


CHARACTER 20 
CHARACTER 20 
CHARACTER 
FIXED 2 
FIXED 2 
ADDRESS 4 

4 

2 


~ 


ADDRESS 
BITSTRING 


BITSTRING L 


wed. 
eeel 


@eeeo Vises 


eel. 
BITSTRING 1 
eell 1111 
CHARACTER 1 


eee: ELEL 
CHARACTER ! 
ee 


ges 


CHARACTER 
CHARACTER 28 


BITSTRING 1 


BITSTRING 1 
ee 


ADRUFOB 
UFOHDR 
UFID 
UFLEN 
UFBDYOFF 
UFVOLI@ 
UFVOLO@ 
UFFUNCT 


UFFUNCTI 
UFFUDEF 
UFFUCOPY 
UFFUREST 
UFFUDUMP 
UFFUPRT 
UFFUCPYD 
* 


UFFUCOMP 
UFFUNCT2 
UFFURLSE 
UFFUCONV 
% 


UFFIND 
UFFIFULL 


UFFIPART 


. UFFIFILT 


UFFIPRTV 
UFFLOGCL 


* 


UFAIFLGS 
UFAIINV 
UFUIMAL 
UFUIMCH 


UFSTOP 
UFSYSIN 
UFSYSPR 


UFNOIN 
UFNOOUT 


* 


UFOFUNCT 


UFOLFLGS 
UFOICOMP 
UFOICVOL 
UFOIPURG 
UFOIRESE 
UFOIWRCK 
UFOLALD 
UFOLALDL 


UFOLALLE 
UFO2FLGS 
UFO2DYNQ 


UFO2ENQE 
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HEADER OF UFO PARM LIST 

IDENTIFIER EBCDIC “UFO ” 

LENGTH OF PARM LIST 

OFFSET TO UFOFUNCT OR UFOPARM 

ADDR OF INPUT VOL LIST | 0 

ADDR OF OUTPUT VOL LIST | 0 

FUNCTION BEING PERFORMED ‘0000’X = PARM 
CHANGE ENTRY (THIS FIELD MUST BE KEPT IN 
SYNCHORNIZATION WITH FBMAJOR IN ADRFUNCB) 
FUNCTION BYTE ONE 

1 = DEFRAG OPERATION 

COPY OPERATION 

RESTORE OPERATION 

DUMP OPERATION 

PRINT OPERATION 

COPYDUMP OPERATION 

RESERVED 

1 = COMPRESS OPERATION 

FUNCTION BYTE TWO 

1 = RELEASE OPERATION 

1 = CONVERTV OPERATION 

RESERVED ; 
FUNCTIONAL INDICATORS 

1 = FULL VOLUME REQUEST (DUMP, RESTORE, COPY & 
DEFRAG) 

1 = PARTIAL REQUEST (DUMP, RESTORE, COPY, 
DEFRAG & PRINT) 


iow tt 


1 
1 
t 
1 
l 


~ 1 = REQUEST BY FILTER/DSNAME (DUMP, RESTORE & 


PRINT) 

1 = PRINT VTOC 

1 = LOGICAL DUMP EITHER NO INPUT VOLUMES SPEC- 
IFIED (CATALOG FILTERING) OR LOGINDDNAME, 
LOGINDYNAM SPECIFIED 

RESERVED 

APPLICATION INTERFACE FLGS 

1=INVOKED BY APPL. INTERF. 

{=ADRUIM NOT TO BE GIVEN CONTROL 

1=DO NOT ALLOW ADRUIM TO MODIFY OPTIONS. 
VALUES 

1=DO NOT SCHEDULE TASK (SAME AS RETURN CODE 8 
FROM ADRUIXIT) 

L=SYSIN OR ALTERNATE NOT PRESENT ALLOWED IF 
UFPARAM = XX 1000XX 

1 =SYSPRINT/ALTERNATE NOT PRESENT ALLOWED IF 
UFPARAM = XX1000XX 

1 =NO INPUT TAPE ONLY FOR RESTORE 

| =NO OUTPUT TAPE ONLY FOR DUMP 


LIST OF OPTIONS FOR FUNCTION. POINTED TO BY THE 
ADDRESS OF UFOHDR + UFBDYOFF. PRESENT IF ANY 
BITS ARE ON IN UFFUNCT 

IST SET OF OPTION FLAGS 

1 = COMPRESS (DUMP) 

= COPYVOLID (RESTORE & COPY) 

= PURGE (DUMP. COPY & RESTORE) 

= RESET CHANGE BIT (DUMP) 

= WRITECHECK 


eee Yama Gees Nein = peed, Geet. 


= ALLDATA 
= ALLDATA(LIST). 0 = ALLDATA( ), VALID ONLY IF 
UFO!IALD = 1. BIT MAY NOT BE SET ON BY THE EXIT 


BUT MAY BE RESET TO CHANGE ALLDATA(LIST) TO 
ALLDATA( ) 


1 = ALLEXCP 

2ND SET OF OPTION FLAGS 

0 = USE ENQ TO HOLD DATASET, 1 = USE DYNALOC 
TO HOLD DS (DUMP. DEFRAG, PRINT & RESTORE) 

1 = ENQ EXCLUSIVE (DUMP. RESTORE AND PRINT) 
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22 


23 


24 





(2) 
(3) 


(4) 
(8) 
(C) 
(10) 


(14) 


(15) 
(16) 
(17) 


(18) 


(1C) 
(0) 


(0) 


(1) 


(2) 
(A) 


Type 


. 
ry 
. 


eeee el.. 


vies el 


IXED 
BITSTRING 


» ee oor 


cose oll 
FIXED 
FIXED 


FIXED 
FIXED 


BITSTRING 


ol. - @eee 


Pre eoee 


ocd e@eoe 


eae ehoe 


FIXED 
FIXED 


BITSTRING 
aleve 
sole 

1113 
BITSTRING 
1... 
ell 111i 
CHARACTER 
CHARACTER 


CHARACTER 
ilies 


well TL 
CHARACTER 
Lewes oa 
ole sees 
ell 12111 
CHARACTER 
CHARACTER 
CHARACTER 
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Length 


Figure 14 (Page 2 of 3). ADRUFO Mapping Macro 
Offsets 





1 
1 


4 


4 
4 
4 


1 


i 


I 


1 


16 


l 


8 
6 





Name 


UFO2ENQS 
UFO2ENQN 


UFO2DEL 
UFO2CTLG 


UFO2RECT 
UFO2UNC 


x 


UFDUOPTM 
UFOINSOP 
UFOERASE 
UFOIACPY 


UFOBLDIX 
UFORACLG 
UFOBK32K 
a 
UFOFRAGI 


UFOMNGAS 


UFOMNSOQT . 


UFOMNTUS 


UFO3FLGS 
UFO3FORC 
UFO3REPL. - 
UFOFRBLK 


UFODRBLK 


UFOALLMU 
UFOSPHER 
UFONOSMS 
UFONMGMT 
UFOWAITS 


UFOWAITR 


UFOTGTAL 
UFOTGTCY 
UFOTGTTR 
UFOTGTBL 

UFOTGTSR 

* 


UFOPROCK 


UFOPRUND 
UFOPRSYS 
* 


* 


ULFOPARM 


UFSERPAR 
UFFORSER 
CFDEFPAR 


* 


UFXAFLAG 
UFXABUFF 
UFAI3iB 

* 


UFWKUNIT 
CFWKVOL 
* 


Description 


| = ENQ SHARED IF EXCL FAILS DUMP, RESTORE & 
PRINT 

| = DO NOT ENQIF EXCL & SHR FAIL DUMP, RESTORE 
& PRINT 

| = DELETE AFTER DS DUMP 

1 = CATALOG DATA SETS DURING A DATA SET 
RESTORE, COPY i ie ee 


1 = RECATALOG DURING A DATA SET RESTORE, COPY 


| = UNCATALOG DATA SETS AFTER A DATA SET 
DUMP, COPY 

RESERVED 

OPTIMIZE VALUE (DUMP/COPY) (1, 2, 3, OR 4) 
INSTALLATION OPTIONS 

1 = ERASE DASD TRACKS 

1 = DUMP MUST PRODUCE ALL OUTPUT COPIES OR 
NONE AT ALL 

1 = INVOKE ICKDSF TO REBUILD VTOC INDEX 
RACFLOG = YES SPECIFIED OR FORCE RACF LOGGING 
TAPE BLK SIZE 32K 

RESERVED 

FRAGMENTATION INDEX(DEFRAG) 9,90,900 = 900, 09 =90, 
009=9 

MINIMUM WASTED SPACE ON A PDS COMPRESSPDS 
MINIMUM SECONDARY ALLOCATION QUANITY 
MINIMUM UNUSED TRACKS RELEASEUNUSED , 
CHANGEALLOC 

3RD OPTION FLAG BYTE 

1 = FORCE UNMOVABLES ON COPY, RESTORE 

1 = REPLACE(DATASET COPY, RESTORE) .. 

1 = FORCE REBLOCKING OF DATA SETS (COPY, 
RESTORE) 

1 = DISABLE REBLOCKING OF DATA SETS (COPY, 
RESTORE) 

1=SEARCH ALL VOLUMES FOR COPY OR DUMP 

1 =PERFORM SPHERE PROCESSING 

| = NULLSTORCLAS SPECIFIED 

L=NULLMGMTCLAS SPECIFIED 

WAIT TIME IN SECONDS BETWEEN RESERVE & ENQ 
RETRIES(ALL) 

NUMBER OF RETRIES ON RESERVE OR ENQ 
FAILURES(ALL COMMANDS) 

TGTALLOC FLAGS 

| = CYLINDER 

TRACK 

BLOCK 

SOURCE 

RESERVED 

PROCESS OPTIONS (THIS FIELD MUST BE KEPT IN SYNC 
WITH FBPROCKW) 

| = PROCESS UNDEFDSORG 

| = PROCESS SYS! 

UNDEFINED 


hood 


It 


EXECUTE CARD PARAMETER OPTION LIST. POINTED 
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1 = FORCE TO SERIAL 
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VOLUME LIST HEADER. POINTED TO BY UFVOLI AND 


UFVOLO 
HEADER 
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COUNT OF VOLUME LIST ENTRIES 


RESERVED 


VOLUME LIST ENTRY 


ADDR OF UCB | 0 
DDNAME ! BLANK 


VOLUME SERIAL | BLANK 


RESERVED 


Name 


UFOTGTCY 
UFOTGTSR 
UFOTGTTR 
UFOVCNT 
UFOVENT 
UFOVHDR 
UFOVOL 
UFOVOLID 


UFOVUCB@ 


UFOWAITR 
UFOWAITS 
UFOIALD 
UFOIALDL 
UFOIALLE 
UFOICOMP 
UFOICVOL 
UFOLFLGS 
UFOIPURG 
UFOIRESE 
UFOIWRCK 
UFO2CTLG 
UFO2DEL 
UFO2DYNQ 
UFO2ENQE 
UFO2ENON 
UFO2ENQS 
UFO2FLGS 
UFO2RECT 
UFO2UNC 
UFO3FLGS 
UFO3FORC 
UFO3REPL 
UFSERPAR 
UFSTOP 
UFSYSIN 
UFSYSPR 
UFUIMAL 
UFUIMCH 
UFVOLIi@ 
UFVOLO@ 
UFWKUNIT 
UFWKVOL 
UFXABUFF 
UFXAFLAG 
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installation Reblock Exit Routine 
The installation reblock exit routine is given control when a SAM or PAM data set 
is being processed during a data set COPY or RESTORE if either: 


¢ You specify REBLOCK(dsn [...]) in the COPY or RESTORE statement, the 
installation options exit routine (ADRUIXIT) does not override it, and the data 
set being copied meets the filtering criteria passed in the REBLOCK sublist 
(fully- or partially-qualified data set names). 


¢ The installation options exit routine forces all data set COPY or RESTORE 
functions to use the reblock exit routine. 


Note: The installation reblock exit is not given control for RECFM=U data sets. 
However, PDS load module data sets are reblocked, if requested, by IEBCOPY 
COPYMOD. 


The installation options exit routine cannot change the REBLOCK sublist (fully or 
partially qualified data set names), except: 


¢ It can prevent DFDSS from reblocking if you specified aac da [...]) 
and 


¢ It can force DFDSS to reblock all SAM/PAM data sets peiid oes (eauiedea 
to REBLOCK(**)). 


e If the reblockable indicator is on in the data set’s Format 1 DSCB 
(DSIREBLK), DFDSS automatically reblocks the data set to a system deter- 
mined blocksize. The reblock exit routine is not called. 


The DFDSS rebiock exit routine passes a return code of zero, which allows DFDSS 
to use an optimal system generated block size. 


Some Suggestions for Using the Installation Reblock Exit 
You can use this exit to verify or change blocksize. For DFP Version 3 Release 1, 
the reblock exit can set a new reblockable indicator that will cause the data set to be 
automatically reblocked when the data set is copied by DFDSS or another program. 


Installation-Supplied Reblock Exit Routine 
Your installation can replace the DFDSS exit routine to override the 
DFDSS-selected block size. If the exit routine passes an invalid block size, the data 
set is not processed and message ADR453E is issued. | 


The name of the reblock exit routine must be ADRREBLK, it must be link-edited 
with the DFDSS load module ADRDSSU, and it must be written in reentrant code. 


DFDSS loads the following registers as input to ADRREBLK: 


Register 1: Pointer to a 6-word parameter list. 
Register 13: Pointer to a standard 18-word save area. 
Register 14: Return address. 

Register 15: Address of ADRREBLK. 


The six word parameter list contains the following information. You can use the 


ADRRBLKB mapping macro, see Figure 15 on page 159, to map this parameter 
list. 
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First word— 
Pointer to a 140-byte work area that has the Format 1 DSCB. For multivolume 
data sets, the extent fields are for the first volume only. 


Second word— 
Pointer to the 6-byte volume serial of the input volume. For a multivolume data 
set, this volume serial is for the first input volume. 


Third word— 
Pointer to the 4-byte device type field of the input volume. This is in the format 
of the UCBTYP field in the UCB. 


Fourth word— 
Pointer to the 6-byte volume serial of the output volume. For a data set that 
spans multiple output volumes, the serial is for the first volume. 


Fifth word— 
Pointer to the 4-byte device type field of the output volume. Its format is 
similar to that for the input volume. 


Sixth word— 
High-order bit (bit 0) is on to indicate the end of the parameter list. The next 
bit (bit 1) indicates that the MVS/XA DFP Version 2 DASDCALC function was 
used to calculate the optimum block size for the target data set. 


~ The 3rd and 4th bytes of the sixth word contain the block size selected by DFDSS 
for the data set on the output volume. This is in the same format as the DSIBLKL 
field in the Format 1 DSCB (fixed binary). 


Your ADRREBLK routine should issue a return code in register 15 to indicate the 
course of action for further processing by DFDSS. Standard register save and 
restore conventions must be observed. 


The return codes and their meanings are: 


Return Code Meaning 


0 Block size not changed. Use the DFDSS-selected block size. 

4 Block size has been changed by the exit; the new block size is indicated 
in last 2 bytes of word 6 of the parameter list. 

8 Use the input block size (do not reblock). 

Po System determined block size will be used. In addition, the reblockable 


indicator in the Format 1 DSCB (DSIREBLK) will be turned on. 


The example below shows you how to link-edit your ADRREBLK routine. This 
exampie assumes that module ADRREBLK is in USERLIB (a cataloged APF 
authorized library). 


//NAME JOB (user accounting information) 
// EXEC PGM=HEWL, 
// PARM='LIST,LET,NCAL,RENT ,AC=i,XREF,AMQDE=31' 
//SYSPRINT DD SYSOUT=A 
//SYSUT1 DD UNIT=SYSDA, SPACE=(CYL, (1)) 
//SYSLMOD DD DSN=SYS1. LINKLIB, DISP=OLD 
//USER DD DSN=USERLIB,DISP=SHR 
//SYSLIN DD x 

INCLUDE USER (ADRREBLK) 

INCLUDE SYSLMOD (ADRDSSU) 

ENTRY ADRDSSU 

NAME ADRDSSU(R) 
f= 
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(0) CHARACTER 
(0) ADDRESS 
(4) ADDRESS 
(3) ADDRESS 
(C) ADDRESS 
(10) ADDRESS 
(14) BITSTRING 
— 
ws 
tol 
CHARACTER 
FIXED 


Figure 15. ADRRBLKB Mapping Macro 


Name 


ADRRBLKB 
RBDASDCS 
RBDSCB@ 
RBEND 
RBENDLST 
RBIDEV@ 
RBIVOL@ 
RBLKSIZE 
RBODEV@ 
RBOVOL@ 
RBRSTCPY 
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ADRRBLKB 
RBDSCB@ 
RBIVOL@ 
RBIDEV@ 
RBOVOL@ 
RBODEV@ 
RBEND 
RBENDLST 


RBDASDCS . 


RBRSTCPY 


* 


* 


RBLKSIZE 


Hex 
Offset 
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Struct 
Level 


Description 


PTR TO FORMAT | DSCB 

PTR TO INPUT VOLSER 

PTR TO INPUT DEVICE TYPE 

PTR TO OUTPUT VOLSER 

PTR TO OUTPUT DEVICE TYPE 

LAST WORD IN PARM LIST 

END OF PARAMETER LIST 
1=DASD CALCULATION SERVICE 

1=CALLED FOR RESTORE 0=CALLED FOR COPY 

UNUSED 

UNUSED 

SELECTED BLOCKSIZE 





There may be times when you wish to customize ISMF. Following are the libraries 
vou can customize and some restrictions when you customize. MVS/DFP Version 3 
Release 2: Customization discusses ISMF restrictions and customization with 
DFDSS in detail. 


ISMF Libraries That Can Be Customized 


You can customize the following libraries of ISMF: 


The Panel Library 
ISMF allows you to make the following changes to the panel library: 


e¢ Change the initial priming values that ISMF ships 

¢ Change the default values for data entry panels 

¢ Provide additional restrictions to values entered for certain fields on panels 
e Remove fields from functional panels 

e Change highlighting and color 

e Change the format of the panel 

¢ Modify existing functional panel text and help text 

¢ Add new fields to panels 

e Add new panels. 


The Message Library 
In the message library you can modify existing messages and add new messages. 
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The Skeleton Library 
In the skeleton library you can modify the job skeletons for ISMF commands 
and line operators. 


The Table Library 
In the table library you can modify the ISPF command tables. 


The Load Library 
' In the load library you can modify the ISMF command and line operator tables. 
The tables are contained in nonexecutable CSECTS in the load library. 


The CLIST Library 
In the CLIST library you can modify the options on the CLIST CONTROL 
statement. 


Restrictions to Customizing ISMF 
Following are some general restrictions to customizing ISMF: 


1. Before you change anything, you should make a backup copy of ISMF. Keep 
this unmodified version of the product for diagnostic purposes. IBM support 
and maintenance is provided for only the unmodified version of ISMF. 


2. Do not delete or rename any of the parts of ISMF. Deleting or renaming a part 
could severely impact processing or cause ISMF to fail. 


3. ISMF is copyrighted. Under the IBM licensing agreement you may modify | 
ISMF for your own use. You may not modify it for commercial resale. 
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Appendix A. Compatibility Considerations for Prior Releases 


Access Authority 


Deleting Data Sets 


Data Set DUMP 


Data Set RESTORE 


LOGICALVOLUME 
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The type of access authority required by DFDSS Version 2 for processing 
RACF-protected data sets and password-protected data sets is the same as in 
DFDSS Version 1 Releases 2.0 and 2.1. In addition, DFDSS Version 2 and DFDSS 
Version 1 Release 2.1 support data sets protected by RACF generic profiles. If you 
do not have DATASET access authority to a multivolume data set, you must have 
DASDVOL access authority to all volumes on which the data set resides. 


In Version 2, if DELETE is specified on a data set COPY, a successfully processed 
data set is scratched from all the volumes on which it resides and is uncataloged. 
(On a data set DUMP, this is true only for a logical dump.) Otherwise, it processes 
as in Version 1 Release 2.1, where only single volume non-VSAM data sets are 
scratched and uncataloged. In Version 1 Release | through Release 2.0, non-VSAM 
data sets are scratched but not uncataloged from the source dump volume. . 


In Version 1, not specifying the input volume(s) resulted in an error message. In 
Version 2 Releases 1 and 2, not specifying the input volumes resulted in a logical 
data set DUMP. The data sets and the volumes to be processed were determined 
from the catalog(s). In Version 2 Releases 3 and 4, a logical data set dump can be 
done on a volume if you use LOGINDD or LOGINDY. 


In Version |. not specifying the output volume(s) resulted in an error message. In 
Version 2, if output volume(s) are not specified, the target volume(s) for the 
RESTORE are determined from either: 


The information kept on the dump tape if the data set does not exist in the 
catalog 


The catalog (standard catalog search order) if the data set does exist. In this 
case, REPLACE must be specified. 


In DFDSS Version 2. you can do a data set RESTORE from full volume or data set 
dump tapes created by Version |. The following limitations apply: 


Because multivolume data sets were not supported on data set dumps in Version 
1, these data sets cannot be restored in their entirety. Also, multivolume data 
sets will not be cataloged during a RESTORE. 


DFDSS will not be able to redefine the VSAM data sets. You may have to - 
define them with the RECATALOG option. 


In Version 2, the LOGICALVOLUME keyword is ignored when you do a 
COPYDUMP on data from a Version 2 logical dump. The COPYDUMP function 
cannot isolate data by volume from these tapes. 


WORKSIZE 
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In Version 2, the DEFRAG WORKSIZE keyword is ignored. 


VSAM key range data sets 


PRINT 


In Version 2, data set COPY, logical data set DUMP, logical data set RESTORE, 
and PRINT can process VSAM key range data sets. The cluster names of these data 
sets should be specified in the EXCLUDE keyword if they are to be excluded from 
processing. 


In Version 2, a data set PRINT results in printing tracks in the logical sequence of 
the data set on the volume, not by cylinder-head sequence. Also, you can print 
VSAM components. 


Restoring by Using a Different DFDSS Release 


Tapes dumped by using an older version or release of DFDSS can be restored by 
using a newer version or release. IBM does not recommend and does not guarantee 
that tapes dumped by using a newer version or release of DFDSS can be restored by 
using an older release. However, if the dump tape does not contain any functional 
changes introduced in a newer release, a restore using an older release may be suc- 
cessful. 


Note: VSAM data sets residing on DFDSS data set Dump tapes created in an 
MVS/XA DFP Version 2 Release 2 (or later release) system cannot be restored in an 
MVS/XA DFP Version 2 Release 1 or an MVS/370 DFP Version | system withont 
certain VSAM N*512 toleration PTFs. 


Figure 16 on page 163 shows whether a tape dumped using one DFDSS release can 
be restored using a different release. Figure 17 on page 163 shows similar informa- 
tion for stand-alone DFDSS restore. 


RESTORE RESTORE 

From V1 R2.1 From V2 
Dump From Full Tracks Data Set Full Tracks Data Set 
VI R21 Yes Yes Yes Yes Yes Yes 
Full 
V2 Yes Yes Yes Yes Yes Yes 
Full 
Vi R21 No Yes No No Yes No 
Tracks 
V2 No Yes No No Yes No 
Tracks 
VI R21 No Yes Yes No Yes Yes 
Physical data set 
V2 No Yes Yes No Yes Yes 
Physical data set 
V2 No No No No No Yes’ 


Logical data set 


Figure 16. System DFDSS RESTORE Compatibility among Releases 
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Compatibility Considerations for Prior Releases: 
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RESTORE RESTORE 

With V1 R2.1 With V2 
Dump From Full Tracks Full Tracks 
V1 R21 Yes Yes Yes Yes 
Full 
V2 Yes Yes Yes Yes 
Full 
VI R21 Yes Yes Yes Yes 
Tracks 
V2 Yes Yes Yes Yes 
Tracks 
Vi R21 No Yes No Yes 
Physical data set 
v2 No Yes No Yes 
Physical data set us he. ad 
V2 No No No No 


Logical data set 
Figure .17.. Stand-alone DFDSS RESTORE Compatibility Among Releases 


Legend for Figure 16 on page 163 and Figure 17: 
Vi R2.1  DFDSS Version | Release 2.1 
V2 DFDSS Version 2 (all releases) 


8 Tapes dumped by using an older version or release of DFDSS can be restored by using a newer version or release. 
IBM does not recommend and does not guarantee that tapes dumped by using a newer version or release of DFDSS 
can be restored by using an older release. How-ver, if the dump tape does not contain any functional changes 
introduced in a newer release, a restore using an older release may be successful. In particular, restoring VSAM 
data sets using a previous DFDSS release is not recommended. 
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Appendix B. Serialization and Authorization Checking 


Data Integrity—Serialization 


DFDSS uses volume serialization and data set serialization functions to ensure that 
data sets are not modified during the processing of DFDSS commands. Volume 
serialization is accomplished by using the RESERVE macro. Data set serialization 
is accomplished by using the ENQ macro and the DFDSS DYNALLOC function. 
In case of shared DASD, volume serialization ensures that data sets are not being 
added, deleted, renamed, or extended from either the same processor or other 
processors. 


You can override data set serialization with the user enqueue exit routine. (See 
Chapter 6, “Customizing DFDSS and Its Interfaces” on page 143 for additional 
information regarding installation enqueue exit routines.) This allows other pro- 
grams to access volumes or data sets while DFDSS is running. It does not affect the 
integrity of any data set other than the one currently being processed. Volume 
serialization, however, cannot be overridden. 


Volume Serialization 
For volume serialization, DFDSS issues a RESERVE on the SYSVTOC to prevent 
direct access device storage management (DADSM) functions from changing the 
VTOC entries during DFDSS processing. The RESERVE is issued before processing 
is begun on a particular volume and released when processing is completed. 
However. DFDSS does not issue a RESERVE for a COPYDUMP. data set 
RESTORE, or data set PRINT operation. You will notice that volume serialization 
by itself does not ensure integrity at the data set level. For example. in the case of a 
dump other than a data set DUMP. data sets are not serialized, and they could be 
changed while a DUMP is being taken. 


DFDSS reserves a VTOC when it is accessed during COMPRESS. RELEASE, and 
COPY (with input volume specified). It is also reserved when updating the 
RACF-defined flag. 


DFDSS operates at the volume and data set levels. To prevent activity on the 
VTOC at the volume level (such as addition, deletion, extension, or renaming of data 
sets), the VTOC is locked during COPY, DEFRAG, DUMP, PRINT (except data 
set prints). and RESTORE (tracks and full). Of these, the COPY. DEFRAG. 
DUMP. PRINT (tracks), and RESTORE functions may need to access catalogs for 
VSAM data sets, to check authorization to access the data sets on the volume. If 
another job on the system (for example, an Access Method Services DEFINE 
command) has already locked the catalog and needs the VTOC for a DADSM func- 
tion (such as the ones described above), a deadlock can result between DFDSS and 
the other job. To avoid this, you should not run any jobs (for example. 

VSAM, Access Method Services jobs) that need to gain control of both the catalog 
and the VTOC while DFDSS is executing. 
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Serialization and Authorization Checking 


Avoiding Lockout 


When an application program attaches a DFDSS dump or restore task and a task 
that invokes dynamic allocation to allocate a data set (for example, logical 
RESTORE) or invokes DADSM to scratch a data set, there is a possibility that the 
two tasks will lock each other out. To avoid this lockout, DFDSS uses the following 
ENQ scheme: 


¢ Before DFDSS invokes DADSM SCRATCH, an exclusive ENQ is requested for: 
the resource with a major name of ADRLOCK and a minor name of the volser 
(padded with blanks to 8 bytes). 


¢ Before DFDSS invokes dynamic allocation to allocate a new data set on a spe- 
cific volume, a shared ENQ is requested for the resource with a major name of 
ADRLOCK and a minor name of the volser (padded with blanks 8 bytes). If 
this is a non-specific dynamic allocation request, an exclusive ENQ with the 
resource with a major name of ADRLOCK and a minor name of NONSPEC is 
requested. 


* Ifan application program invokes DFDSS FULL DUMP and plans on 
attaching another DFDSS logical RESTORE task, the application should 
request the first resource in exclusive mode (ADRLOCK, volser). The applica- . 
tion should request the second resource in shared mode (ADRLOCK, 
NONSPEC) before attaching the FULL DUMP task. Multiple DUMPs can be 
active in the same address space and a logical RESTORE request will not lock ~ 
out that task. oe Oo a _ . 


If an application program issues a DADSM request, the application must 
enqueue on ADRLOCK/volser in a shared ENQ or ADRLOCK/NONSPEC in 
an exclusive ENQ. 


Notes: 


it. When DFDSS is invoked with JCL, lockout does not occur because DFDSS 
allocates a volume before invoking DADSM. Ifa FULL DUMP has the 
volume enqueued and a restore task has been applied against the same volume, 
the restore task is held until the volume is available. 


2. Only non-SMS, non-VSAM DADSM requests require serialization. 


Data Set Serialization 


Enqueuing—ENQ 
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The following material describes using enqueue options for data set serialization. 
Enqueues are done on the data set name for data set COPY, data set DUMP, data 
set RESTORE, DEFRAG, PRINT, COMPRESS, and RELEASE to prevent mul- 
tiple. simultaneous updates to the same data set. 


The SHARE option applies to non-VSAM data sets only (RESTORE, DUMP, and 
COPY). 


If SHARE is not specified by the user with a DFDSS command, DFDSS tries to 
provide the highest level of data integrity by defaulting to exclusive enqueuing. If 
the enqueue fails, the command is put in a wait state for X seconds, where X is 
specified in WAIT(numsecs,numretries), and the enqueue is retried. If the wait- 
enqueue sequence fails after Y retries, where Y is specified in 

W AIT(numsecs,numretries), processing ends for the data set. 
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If you specify the SHARE keyword, DFDSS tries an enqueue for share. If it fails, it 
goes through the same logic as if SHARE had not been specified. If the retries all 
fail, processing ends for the data set. 


You can specify TOLERATE(ENQFAILURE) in addition to the default, ENQ, or 
the SHARE option. If TOLERATE(ENQFAILURE) is specified, DFDSS attempts 
to get the specified level of enqueue, exclusive or share. If the enqueue fails after the 
specified or default number of retries, DFDSS processes the data set without an 
enqueue. You should specify TOLERATE(ENQFAILURE) if you are willing to 
tolerate the exposure of not having data integrity in order to force the successful 
completion of that particular data set operation. DFDSS respects data set integrity 
by not processing partially-qualified VSAM data sets which are opened for update. 
In order to force TOLERATE(ENQFAILURE) on data set that is in open status, a 
fully-qualified name is required. This is particularly useful when an installation has 
duplicate data sets (different data sets with the same name but on different volumes) 
and you want to run DFDSS on a data set on one volume while the data set with 
the same name is being used by the system or another job on a different volume. 


Note: Because of ENQ contention, SYSPRINT data sets should not be allocated on 
volumes being processed. TOLERATE(ENQFAILURE) cannot apply to data. 
movements that involve the use of utilities. 


Figure 18 on page 167 shows the data set enqueue options. 


TOLERATE(ENQFAILURE) can be used on VSAM and non-VSAM data sets. . 


SHARE and 
Opticns None SHARE TOLERATE(ENQFAILURE) TOLERATE(ENQFAILURE) 
Type of enqueue Exclusive Share Exclusive Share 
If enqueue is suc- Process Process Process Process 
cessful 
If enqueue is not Do not Do not Process Process 
successful process process 


Figure 18. Data Set Enqueue Options for Non-VSAM Data Sets Specified on DFDSS Commands 


Dynamic Allocation—DYNALLOC 
DYNALLOC is an option for data set DUMP, data set COPY, data set RESTORE, 
data set PRINT, DEFRAG, COMPRESS. and RELEASE. It allows serialization of 
data sets across processors with shared DASD. with JES3, and with the interface 
between dynamic allocation and JES3 enabled. SVC 99 causes DYNALLOC to seri- 
alize data sets. Processing time increases because overhead is involved in dynamic 
allocation and serialization across multiple processors. 


If you use DYNALLOC to serialize data sets (as opposed to ENQ) the job run time 
will increase. If you use INDYNAM instead of DD statements to allocate DASD 
volumes you do not appreciably increase run time and coding of JCL and command 
input 1s easier. 
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Enqueuing versus Dynamic Allocation of Data Sets 


For data set operations, the default method of serializing usage of data sets is to 
enqueue on the data set name. If DYNALLOC is coded in the control cards, the 
time taken to serialize is much greater than that taken by using the ENQ macro. So 
the DYNALLOC keyword should be used judiciously. It should be used only on a 
JES3 system if the interface between the allocation function and JES3 is not disa- 
bled. If the interface is disabled, then the end result of serialization using ENQ is 


‘the same as using SVC 99; ENQ takes much less time to serialize data sets. 


When you use DYNALLOC, the selected data sets are allocated to DFDSS. If 
some data sets are allocated to the system, they can only be processed by DFDSS 
with DYNALLOC if SHARE is also specified. Figure 20 on page 170 provides 
additional information on data set serialization. 


Read/Write Serialization Scheme 
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Figure 19 on page 169 shows the serialization scheme used by all operations, except 
COPYDUMP, for read/write access. 


Serialization and Authorization Checking 






ENQ Control, 
ENQ Names ENQ Names Exclusive (E) 
Major Name Minor Name or Share (S) 


Non-VSAM Data Sets SYSDSN Data set name E (SHARE not SYSTEM 
specified) 
S (SHARE 
specified) 














VSAM Data Sets 


On each component SYSVSAM See Note E SYSTEMS 
On the cluster SYSDSN Cluster name E (SHARE not SYSTEM 
specified) 
S (SHARE 
specified) 
Integrated catalog facility catalog 
In addition to above SYSIGGV2 Catalog name E SYSTEMS 
On the Volume SYSVTOC Volume serial 7” OE ' SYSTEMS 
number 
VVDS Data Set. Sad SYSZVVDS . SYSI.VVDS.. |. |... - _  . SYSTEMS 
Vvolser 
Input access S | 
Output access E 3 


If DYNALLOC its used: 


| For non-VSAM{ data sets, instead of ENQ, the data set is allocated automatically via SVC99, with 
a disposition of OLD if SHARE ts not used; otherwise, SHARE is the disposition. For VSAM data 
sets, in addition to the ENQ, the cluster is allocated dynamically just as for non-VSAM data sets. 


Note: The minor name consists of: 


Ll: Tota! ‘ength of minor name 
L2: Component name length 
L3: Cataiog name length 


On a data set DUMP. an ENQ is done once with the character A=B and again with A=O. 
On a data set RESTORE and DEFRAG, an ENQ is done once with A=B and again with A=I. 
On a data set COPY, an ENQ is done once with A=O., 








Figure 19. Read Write Access Serialization Scheme 


WAIT Option 


This option allows you to specify how long, in seconds, DFDSS is to wait for a 
resource and the number of times DFDSS is to retry, should an ENQ or RESERVE 
fail. The default is WAIT(2,2). This means DFDSS is to retry twice at 2-second 
intervals. 
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For a data set COPY or logical data set DUMP, the WAIT option has a different 
meaning for serializing data sets when multiple data sets are to be processed and 
WAIT(0,0) is not specified. Multiple passes are made through the list of data sets 
that are selected. On each pass, those data sets that can be serialized without 
waiting for the resource and that were not processed before are processed. At the 
end of a pass, if none of the data sets could be processed without waiting for a 
resource, then, in the next pass, at the first occurrence of a data set that was not 
processed a WAIT will be issued. That data set and the remainder of the list will be 
processed if possible. The above procedure is repeated until all data sets are proc- 
essed or the WAIT limits are reached. For example, if WAIT(3,10) is specified and 
5 data sets are left to be processed, up to 10 passes are made. On each pass, the first 
unprocessed data set is waited upon for 3 seconds. Thus, only a 30-second 
maximum will ever be WAITed, not 150 (5 times 3 times 10). 


Data Set 
Volume Level Level 
Serialization Serialization 
(ENQ or 
DYNALLOC). 


Non-VSAM DSName 
Non-V SAM “es DSName 


Function a _ VTOC VVDS 


COMPRESS 
CONVERTV 


‘Data Set COPY 





Non-VSAM 
VSAM 


DSName 
Component and Cluster 
Names 





DEFRAG Non-VSAM Yes i/A DSName 
| VSAM Yes. “Yes Component and 
Cluster Names 
Full DUMP Non-VSAM Yes N/A N/A 
VSAM Yes Yes NA 
| Data Set DUMP Non-VSAM Yes N/A DSName 
VSAM Yes Yes Component and 
Cluster Names 
Data Set PRINT Non-VSAM Yes N/A DSName | 
VSAM Yes Yes Component Name 
Tracks PRINT Yes N/A N/A 
RELEASE Non-VSAM Yes N/A DSName 
Full RESTORE Non-VSAM Yes N/A N/A 
VSAM Yes Yes NA 
Data Set RESTORE Non-VSAM N/A N/A DSName 
VSAM N/A Yes Component and 


Cluster Names 





Figure 20. Resource Serialization 


Notes to Figure 20: 
e VSAM data sets must be cataloged in an integrated catalog facility catalog. 


¢ N/A means not applicable. 
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An Example of RESERVE-ENQUEUE Processing 


If you were to enter the following: 

DUMP INDD(IN1) OUTDD(OUT1) - 

DATASET (INCLUDE (MY.DUMP.DATASET1,MY.DUMP.DATASET2)) - 

WAIT(5,2) - 

SHARE 

The following would result: 

1. DFDSS issues a RESERVE on SYSVTOC (this is the default) 

If RESERVE fails, DFDSS retries two times at 5-second intervals. 
If RESERVE is successful, DFDSS continues. 


If either of the data set was a VSAM or SMS-managed data set, the VVDS 
would also be serialized by DFDSS. If VVDS serialization fails, none of the 
data sets are dumped. 


WN 


. DFDSS issues a shared enqueue on data set name. If the shared ga fails, 
DFDSS retries two times at 5-second intervals. a 


If the shared enqueue is successful: 


DFDSS adds the data set name to the list to be dumped. 
DFDSS loops back to the beginning of this step until an enqueue is 
tried for all data sets. 


If the shared enqueue fails: 


DFDSS issues message ADR412E. 

DFDSS sets condition code = 8 

DFDSS loops back to the beginning of this step until an enqueue is 
tried for all data sets. 


3. After an enqueue is tried for all specified data sets: 


DFDSS dumps the VVDS (if an integrated catalog facility data set was 
selected) and the VTOC and dequeues the VTOC. 


If VVDS was enqueued, it is dequeued by DFDSS. 

DFDSS dumps each data set that was successfully enqueued. 
DFDSS dequeues the enqueued data sets. 

DFDSS issues message ADR3781. 


Keep in mind that. if you specify TOLERATE(ENQFAILURE) with the DUMP 
command and the user enqueue exit routine does not override it, the VTOC is not 
dequeued until all the data tracks for all the data sets are dumped. 


DFDSS Authorization Checking 


DFDSS checks authorization on DASD volumes and data sets to ensure that you 
have sufficient authority to access them. The required access authority depends on 
the function being performed and the protection in effect for the entity. The pro- 
tection mechanism can be either Resource Access Control Facility (RACF) or pass- 
word. RACF checking takes precedence over password checking. The system 
operator is also queried for authorization in certain instances. Some system data 
sets and VSAM data sets are defined to accept authorization from the operator when 
RACF or password checking cannot be used (for example, in accessing the VTOC, 
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VTOC index, or VVDS). System Authorization Facility (SAF) is also supported 
(SAF is not supported for MVS/370). 


Note: If you enter data set passwords in the command data set and your job abnor- 
mally ends, these passwords may appear in the dump. To prevent this, you should 
put the passwords in a data set and refer to this data set with a DD statement. If 
you enter data set passwords in the command data set, they are ‘Suppressed and do 
not appear in the SYSPRINT data set listing. a 


DFDSS checks Resource Access Control Facility (RACF) authorization at the 
volume and data set levels. If RACF Version 1 Release 5 or later release is installed, 
generic profiles are also checked. If RACF Version | Release 7 (or later release) and 
MVS/XA Data Facility Product Version 2 Release | (or later release) are installed, 
the erase-on-scratch RACF data set profile attribute is supported during data set 
DUMP with DELETE, data set COPY with DELETE, DEFRAG, and RELEASE. 


Access authority to the volume is checked first. If you have the required RACF 
authority at the volume level (for example, alter authority for a full volume 
RESTORE), checking at the data set level is not performed. If you do not have the 
required volume level authority or if the volume is not protected or the protection 
status of the volume cannot be determined, only then is checking performed at the 
data set levei. 


For a full volume operation, you must have required access authority to the volume 
itself or to all the data sets on the volume. For a tracks or data set operation, you 
must have the required access authority to the volume itself or to the data sets that 
map the required extents. Full and tracks operations are ended if you do not have 
sufficient authority. For data set level operations. if vou do not have volume level 
access, only the subset of those required data sets tnat you have access to is proc- 
essed. 


Authorization checks are not done for COPYDUMIP. 


Authorization checking at the data set level is bypassed in the following cases, where 
it is considered to be equivalent to your having volume level access: 


The JSCBPASS (bypass authorization check) indicator is on in the JSCB Gob 
step control block), or 


Your authorization exit routine so directs. 


An installation-supplied installation authorization exit routine can allow special priv- 
ileged users to bypass all or some of the authorization checking. Security processing 
does increase the time required to perform various DFDSS functions. [f RACF, 
password checking, or other security features are used for a large number of data 
sets, the elapsed time of an operation can be increased. Note that when you invoke 
this exit you cannot bypass authorization checking initiated by utilities (such as 
IEBCOPY) that are invoked by DFDSS. See “Installation Authorization Exit 
Routine (ADRUPSWD)” on page 143 for details on the installation authorization 
exit. See Figure 22 on page 176 for information on when DFDSS invokes utilities. 


Serialization and Authorization Checking 


so8 Bah Ske REE oa Ro 


Volume Authorization Checking 
RACF DASDVOL protection is the only protection checked by DFDSS at the 
volume level. If other means of protection are normally used in a given installation, 
an installation-supplied installation authorization exit routine must check your access 
authority. See “Installation Authorization Exit Routine (ADRUPSWD)” on 
page 143 for details. The installation authorization exit routine supplied with 
DFDSS does not provide this function. DFDSS does, however, check for 
DASDVOL access authority if RACF DASDVOL class is active on the system. 


If RACF DASDVOL class is active and a profile exists for the specified volume, 
your access authority is determined. If RACF DASDVOL class is active but a 
profile does not exist for the volume, the volume is not protected. If RACF 
DASDVOL class itself is inactive, the protection status of the volume cannot be 
determined. If RACF DASDVOL is inactive or no profile exists, the user is given 
authority. 


Figure 21 on page 175 lists the RACF DASDVOL access authority checked by 
DFDSS, by function and type of access. 


Data Set Authorization Checking 


Data set authorization is checked if: 


¢ System utilities are invoked for data movement. 

¢ You do not have the required RACF DASDVOL access. 

¢ Data set authorization checking is not bypassed either with the JSCBPASS bit 
indicator or your authorization exit routine. 


Data sets can be protected by the RACF DATASET class mechanism, the password 
mechanism, or both. If a data set is protected by both mechanisms, only the RACF 
DATASET access authority is checked. If a data set is not protected by either 
mechanism. DFDSS assumes that all users have required access to it unless the data 
set is any of the following: 


¢ A ccheckpoint/restart data set 

e A VTOC index data set 

e A VVDS data set 

e Marked as RACF protected but RACF is inactive 

e A VSAM data set cataloged in an integrated catalog facility catalog but the 
VVDS is not on the volume. 


In these cases, DF DSS prompts the system operator to determine whether you can 
de allowed the required access. Keep in mind that the operator is always prompted 
for the VVDS data set even if it is protected by other means. Also, the operator 
message. ADR369D, contains only the generic phrase RACF PROTECTED 
SYSTEM DATASET but not individual data set names. The operator is only 
prompted for the first data set encountered in this class. The reply given by the 
operator is used for subsequent data sets of this type on the volume. 


The checking mechanism used is based on the type of data set: VSAM, non-VSAM, 
and so on. The access authority required depends on the function and type of oper- 
ation being performed: 


¢ Non-VSAM RACF-protected data sets. If RACF Version | Release 5 or 
System Authorization Facility (SAF) is installed on your system, all data sets are 
checked as though they were RACF protected. This is because of the generic 
profile function supported by RACF Version | Release 5 and System Authori- 
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zation Facility (SAF). If RACF Version | Release 4 is installed on your system 
but SAF is not, the data sets are checked for RACF protection only if they are 
specified as RACF protected. Authorization is checked by calling the RACF 
facilitv. The access authority required is given in Figure 21 on page 175. 


VSAM data sets. Authorization for accessing VSAM data sets (except VVDS) is 
checked by using the catalog management services. Authorization for overlaying 
the VVDS is obtained by prompting the operator. The master password is 
required to read from or write to a catalog for: 


A DUMP, COPY, or RESTORE 
A tracks PRINT. 


The master password is also required to write to the output volume for: 


A full or tracks RESTORE 
A full or tracks COPY. 


Authorization is checked by calling the RACF facility. The access authority 
required is given in Figure 21 on page 175. 


VSAM data sets not cataloged under the integrated catalog facility catalog. _. 
Authorization is checked by opening the data space for input (for input oper- 
ations) or output (for output operations). The data set must be cataloged in the 
standard order of search. 


Noa-VSAM password- pissed dati sets. If the DASD Blt | is the target 
volume fora RESTORE or COPY operation or if it is a DUMP command, the 
write password must be supplied. In all other cases, a read password suffices. 
Passwords must be supplied by using the PASSWORD keyword of the appli- 
cable command. 


When RACF Version | Release 5 or an earlier release is installed, if you have 
DASDVOL access at the proper authorization level but not the proper data set 
authorization and you do not have the RACF special and operations attributes: 


— When DFDSS attaches utilities in processing non-VSAM data sets for 
COPY and COMPRESS operations. the utilities abend with a 913 code. 


— When restoring KSDS and key range data sets to unlike devices, message 
ADR437E (VSAM open error) is issued and the data set is not restored. 


When RACF Version 1 Release 6 or a later release is installed, RACF 
DASDVOL authorization checking is honored. However, DASDVOL authority 
is not sufficient if you want to use to move (COPY with DELETE) a RACF 
protected VSAM data set. To copy a data set, DFDSS uses ALTER 
NEWNAME to change the name of the data set being copied. ALTER renames 
both the data set and the data set’s RACF profile. If the user doing the copy is 
not 2 member of the group containing the profile, ALTER will fail, causing 
DFDSS to fail the copy. 
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To copy a RACF protected data set, at least one of the following conditions 
must be met: 


— You are a member of the group containing the data set’s profile. 
— You have RACF OPERATIONS authority. 


— The data set’s profile takes the form ‘HLQ*’; a more specific profile name 
prevents DFDSS from copying the data set. 


If the data set is protected by a discrete profile, you must be a member of 
the group because OPERATIONS authority is not sufficient to rename the 
discrete profile. 


These same conditions apply for copying non-VSAM data sets into 
SMS-managed storage. 


To restore a data set that was RACF protected at dump time, you must 
have update access to the target data set. If the data set is to be renamed 
during RESTORE, you must have read access to the source data set as well 
as update access to the target data set. 


For non-VSAM data sets that were protected under a discrete profile that 
no longer exists, you must predefine a new discrete profile or preallocate 
that data set with a discrete profile. 


These conditions do not apply if data set authorization checking is bypassed. 














Type of Access 
on Volume 
| Function or Data Set | Tracks Data Set 
| COMPRESS Input | NA |N/A | Update 
| COPY with DELETE Input 
| Output 
| COPY without Input Read Read Read 
DELETE Output Alter Alter Update 
| COPYDUMP N/A N/A N/A N/A 





DEFRAG? Read Read Read 
DEFRAG® 
DUMP with DELETE N/A Alter 


DUMP without Input Update Update Update! 
| DELETE | 


RESTORE Input NIA NIA Read 
Output Alter Alter Update 


Figure 21. Access Authority Requirement—RACF-Protected Data Sets and DASDVOL 











9 RACF-protected data set access requirement 
10 DASDVOL access requirement 
't ALTER is required for Integrated Catalog Facility VSAM catalogs. 
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Utilities Used for Moving Data Sets 
In some cases, DFDSS invokes a utility to move a data set. Figure 22 shows when 
DFDSS invokes a utility for a data set COPY. 


When you move a data set and a utility is used, the data set must be cataloged in the 
standard search order, = ~~ = © . ee ee 


When DFDSS invokes IEBCOPY to copy a LOADMOD, message IECS07D is 
issued requesting operator authorization to overwrite an unexpired area when the 
source data set has an incorrect RLD count and an unexpired date. 


When DFDSS invokes IEHMOVE to copy data sets, IEHMOVE has DD statement 
requirements that DFDSS cannot always satisfy. To avoid potential abnormal ends, 
do one or both of the following: 


e Specify the source and target volumes as PRIVATE. 


e Ensure that the source and target volumes are not in the list of default volumes 
for dynamic allocation. ee 


| Data Set Type. si Unlike Devices. 
| SAM DFDSS DFDSS 


| PAM DFDSS” DFDSS” 
| PAM load modules DFDSS IEBCOPY'3 


DFDSS IEHMOVE! 


DAM nonrelative block 
address mode 


DAM relative block DFDSS DFDSS 
address mode!5 
ISAM to same track. DFDSS 
MVS’‘XA DFP Version 
2 Release | or later 

; installed. Target volume 

| uses VTOC index. 

' Target space available. 


ISAM (all other cases) | IEBISAM IEBISAM 
ESDS | DFDSS DFDSS 





12 All PAM data sets that are not load modules are compressed during a copy to a like or unlike device. DFDSS also 
compresses track overtlow data sets. 


13 If copying PAM load modules with REBLOCK, then IEBCOPY is used instead of DFDSS to copy the data set. 
14 Not copied if the target data set is preallocated or if the target device has a smaller track capacity than the source. 
15 DFDSS RELBLOCKADDRESS parameter must be specified. 


16 IDCAMS is used if the target’s CISIZE, CASIZE, physical record size, physical block size, or imbed or span attri- 
butes are different from the source's. 


17 IDCAMS is used if the source and target CASIZE, physical record size, or physical block size are different; if the 
components span multiple volumes: for a KSDS with IMBED and either the source HURBA = HARBA or it has 
extended indexes. 
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Data Set Type Unlike Devices 
RRDS DFDSS DFDSS 
KSDS DFDSS'6 IDCAMS (REPRO) 


Key range data set DFDSS" IDCAMS (REPRO) 


CVOL IEHMOVE > IEHMOVE 
















Integrated catalog IDCAMS IDCAMS 
facility user catalogs (EXPORT/IMPORT) (EXPORT/IMPORT) 






Undefined DSORG DFDSS DFDSS 


Figure 22. Data Mover Selection Matrix for Data Set COPY. 





RACF Logging during Authorization Checking 
If you specify the RACFLOG= YES keyword in your EXEC statement or if the 
installation options exit requests RACF logging, DFDSS allows RACF logging as 
follows: . 


¢ During RACF DASDVOL checking, DFDSS allows logging of successful 
authorizations only. This allows tracking of successful authorizations with 
DASDVOL. Unsuccessful attempts are not logged because the user may still 
gain authorization during data set level checking. 


¢ During data set level checking of VSAM data sets, DFDSS has no control of 
RACF logging. Logging of these data sets normally occurs as specified in the. 
applicable RACF profile. 


¢ During data set level checking of non-VSAM daia sets, DFDSS allows RACF 
logging as specified in the applicable RACF profile. 


Figure 21 on page 175 provides additional information regarding RACF-protected 
data sets and DASDVOL. 


Example of Security Processing 
Dump data sets by filter criteria; assume RACF and password-protected data sets 
are on the volume. 


DUMP DATASET(INCL(MY.**) ) 


The security processing that occurs is as follows: 
Authorization checking is not done if any of the following are true: 


1. The IEFSDPPT program property table indicates that DFDSS does not 
require authorization processing. 


2. An installation exit indicates to bypass authorization checking. 
3. The user has RACF DASDVOL update access. 
The following occurs if authorization checking is performed: 


1. Each data set that is RACF-protected is checked for access authority. If 
you do not have authority or if the RACF profile is missing and the data set 
is RACF indicated, the data set is dumped and message ADR402 is issued. 
Processing continues for other data sets. 


2. Password checking is done if the data set is not RACF-protected but is pass- 
word protected. Password checking is also done if the data set is protected 
with both the password and RACF protection mechanisms and RACF is 
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inactive or not supported on the system. If authorization is not obtained, 
message ADR402 is issued, the data set is not dumped, and processing con- 
tinues for other data sets. If this is a system data set (for example, 
checkpoint/restart), operator authorization is obtained. 
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_ Appendix C. User Interaction Module Exit Options 


This appendix provides information that you may need to refer to when you use the 
User Interaction Modules. General-use programming interfaces are contained in this 
appendix. 


Calling Block Structure 


The parameter structure outlined below can be viewed in block form as shown in 
Figure 23 on page 181. 


ADRDSSU 
is the name of the DFDSS module main entry point. 


OPTPTR 
is the name of the pointer to the option list and is similar to the 
OPTIONADDR description used in MVS/DFP Version 3 Release 2: Utilities. 
This provides a way to specify processing options. This parameter must be spec- 
ified even if the list is a null list. This means that if you do not want to specify 
any parameters to DFDSS, this pointer must be specified and must point to a 
haltword of binary zeros. The same values that can be specified in the EXEC 
PARM field in the JCL for DFDSS can be specified in the option list. The first 
field of this list is a halfword field (not on a fullword boundary) giving the 
length of the remainder of the list. (This field is hereafter referred to as the 
option list length field.) If you do not want to specify any options, you must set 
the option list length field to binary zeros. If you specify any options in the 
option list, you must set the total length of the option list (excluding the length 
field itself) in the option list length as a binary value. The options must compiy 
with the parameter syntax of the DFDSS EXEC parameter values. 


If vou do not want to specify subsequent parameters, you can omit them from 
the iist. 


DDPTR 
is the name of the pointer to the DDNAME list and is similar to the 
DDNAMEADDR description used in MVS/DFP Version 3 Release 2: Utilities. 
The DDNAME list provides a way for the user to specify alternate names for 
the SYSIN and/or SYSPRINT data sets. The DDNAME list is a variable 
length field made up of a halfword field followed by unseparated 8-character 
left-justified (right padded with blanks) fields. Each 8-character field is reserved 
for a specific DDNAME. DFDSS uses only two of these fields, that of SYSIN 
(the fifth field) and SYSPRINT (the sixth field). The other fields are provided 
as 4 standard implementation consistent with existing system utility invocation 
procedures. All fields other than the SYSIN and SYSPRINT fields must be 
filled with binary zeros and are ignored by DFDSS. 


The first field of this list is a halfword (not on a fullword boundary) field giving 
the length of the remainder of the list and contains the binary value representing 
the number 48. (This field is hereafter referred to as the DDNAME list length 
field.) If you specify this parameter but do ne‘ want to specify any alternate 
DDNAMES for the SYSIN or SYSPRINT data sets, you must set the 
DDNAME list length field to the correct length and all of the 8-character fields 
to binary zeros. 
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If you want to specify an alternate DDNAME for the SYSIN data set, you must 


specify this parameter and must fill the fifth 8-character field with the alternate 


DDNAME; otherwise, this field must be binary zeros. 


If you want to specify an alternate DDNAME for the SYSPRINT data set, you 
must specify this parameter and must fill the sixth 8-character field with the 
alternate DDNAME; otherwise, this field must be binary zeros. 


If you do not want to specify subsequent parameters, you can omit them from 
the list. 


PAGEPTR 


is the name of the pointer to the page number list and is similar to the 
HDINGADDR description used in MVS/DFP Version 3 Release 2: Utilities. 
This provides a way to specify the starting page number for system output on 
the SYSPRINT data set. The page number list is a fixed-length 6-byte field 
made up of a halfword field followed by a 4-byte EBCDIC page count, which 
specifies the starting page number for DFDSS to use for the SYSPRINT data 
set. If this value is specified here and in the OPTPTR list, this value is used, 
and the corresponding OPTPTR value is ignored. 


The first field of this list is a halfword field giving the length of the remainder of 
the list and normally contains the binary value representing the number 4. This 
field is hereafter referred to as the page number list length field. 


If you do not want to specify a starting Page Number, you must set the page 
number list length field to binary zeros. If you want to specify a starting Page 
Number, you must specify this parameter.and specify a 4-character page value. 
If the Page Number is specified (page number list length field is not binary 
zeros). DFDSS resets this field to the current page number upon completion of 
the present invocation. If the Page Number was not specified (page number list 
length field is binary zeros), this field is not changed by DFDSS. 


If you do not want to specify subsequent parameters, you can omit them from 
the list. 


PARAM 


if you had JCL EXEC PARM = values specified in the calling program, DFDSS 
ignores the parameters in the lists pointed to by register | upon entry to 
DFDSS. 


CIMPTR 


is the name of the pointer to the user interaction module (UIM) list. There is no 
comparable parameter described in MVS/DFP Version 3 Release 2: Utilities. 
This parameter provides a way to specify the name or address of a vector- 
implemented exit module that is to interact with DFDSS for the various I/O and 
data set operations. The UIM list is of variable length and consists of a 
halfword field. The halfword field is followed by a 4-byte address or 8-character 
left-justified (padded on the right with blanks) string field that specifies the 
address of the UIM entry point or the load module name (locatable through the 
normal LINKLIB structure) of the UIM. If you do not want to specify a UIM, 
you should not specify this parameter. 


The first field of this list 1s a halfword field (not on a full word boundary) giving 
the length of the remainder of the list. It contains the binary value representing 
the number 4 if the address of the UIM is being passed, or the binary value 
representing the number 8 when the name of the UIM is being passed. (This 
field is hereafter referred to as the UIM list length field.) 
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If you want to specify a UIM, you must specify the address of the UIM or the 
name of the UIM in the field following the UIM list length field. Fill that — 
length field with the proper binary value of 4 or 8 respectively. See “System 


Programming Information” on page 182 for more details on the use of this 
module. 


When the address of the UIM is specified, DFDSS uses bit 0 of the address to 
determine the addressing mode of the UIM in MVS/XA. If bit 0 is 1, then 
DFDSS assumes that the UIM is to be called in 31-bit addressing mode (which 
is set at link-edit time by specifying AMODE=31). If bit 0 is 0, the UIM is 
called in 24-bit addressing mode. 


UAPTR 
is the name of the pointer to the user area list. There is no comparable param- 
eter in DFDSS Version 2 Release | or prior releases. This parameter provides a 
way to specify the address of an area that you want to be passed to the UIM at 
each DFDSS exit point. The user area list is of fixed length, consisting of a 
halfword length field followed by a single 4-byte address that locates the user 
area Starting address. 


If you use the user area, the address of the user area must be specified in the 
field after the user area list length field, and the length must be set to 4. 


VL 
. indicates that the list is variable length. Both the ATTACH and LINK macros 
require specifying VL=1. 
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Figure 23. DFDSS Application Interface Structure 
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User Interactions 


User interactions can only take place when DFDSS has been invoked by using the 
Application Interface and the name of the user interaction module (UIM) exit 
routine is supplied to DFDSS. DFDSS can be invoked by any of the system macros 
shown in Figure 24. 












| ATTACH EP=ADRDSSU, PARAM=(OPTPTR, DDPTR, PAGEPTR,UIMPTR,UAPTR) ,VL=1 

| or 

LINK EP=ADRDSSU, PARAM=(OPTPTR, DDOPTR, PAGEPTR, UIMPTR, UAPTR) , VL=1 
or 


CALL (15), (OPTPTR, DDPTR, PAGEPTR,UIMPTR,UAPTR) , VL 





Figure 24. Invoking DFDSS with Its Application Interface 


As shown further in Figure 23, a pointer to the UIM exit is passed in the parameter 
list (UIMPTR). Generally, user interactions can be used for: 


e Record management 
¢ Controlling processing of data sets 
¢ Gathering statistics on DFDSS operations. 


See Appendix D, “Examples of the Application Program with the User Interaction 
Module (UIM)” on page 204 for an explanation of the various UIM exits. 


When a UIM exit routine is specified, DFDSS processes normally, then at each 
point in the process (hereafter referred to as DFDSS exit points), the UIM exit 
routine is called conditionally to allow some types of user operations. 


If a DFDSS subtask abnormally ends for any reason, it will be unable to make any 
further calls to the UIM, including the function ending call. 


Note: DFDSS runs as an authorized problem program. Any program invoking 
DFDSS must also be authorized and in a non-supervisor state. 


System Programming Information 


There are some bit definitions in the installation options control block (ADRUFO) 
that permit DFDSS to communicate with the installation options exit routine. 

When the installation options exit does not want a function to be scheduled, it 
returns a code of 8; for the UIM to do this requires a bit definition of UFSTOP to 
be set in the ADRUFO. If there is not to be a SYSIN and/or SYSPRINT data set 
allocated or all SYSIN/SYSPRINT is to be handled in storage, UFSYSIN and 
UFSYSPR specify this to DFDSS. Three additional bits are referred to-UFAINV, 
UFUIMAL and UFUIMCH!8—which determine allowances within the UIM inter- 
action. 


Two additional bits are defined to indicate the existence or absence of an input 
restore;copydump data set or an output dump copydump data set. These are 
UFNOIN and UFNOOUT respectively. 


18 See Data Facility Data Set Services: User's Guide for a definition of these and other acronyms. 
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When DFDSS has been invoked by using the Application Interface and the UIM 
has been specified and is to be called, the following information is passed to the 
UIM on every exit call: 


1. Register 1 points to the interface parameter list pointer. 


2. The interface parameter list pointer is the address of the DFDSS exit identifica- 
tion block. See “ADREIDO Data Area” on page 198 for a detailed description 
of this block. This list basically consists of: 


e A halfword field specifying the length of the remainder of the list. 
e¢ The remainder of the list that is mapped by the macro ADREIDO. See 
Figure 26 on page 183 for a block format of this area. 


Upon return from the UIM, the user return code field is examined to determine the 
disposition of the current I/O record or data set (within the limits allowed to the 
exit). 


Application Interface Blocks: The parameter structure described in Figure 23 on 
page 181 can be viewed in block form as shown in Figure 25. 


REG 1 |——>| Interface Pointer | ————— >|. Length 


Exit Identification Block 





Figure 25. DFDSS Exit Interface Structure 


Exit Identification Block: The exit identification block is shown in block form in 
Figure 26. 





Control Block Eye-catcher (supplied by DFDSS) 






TASK-ID (supplied by DFDSS) 












Installation Exit Allowance (supplied by DFDSS) 


Figure 26. DFDSS Exit Identification Block 
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The exit identification block is passed to the user interaction module every time 
DFDSS gives control to it. Each field is described below, but see “ADREIDO Data 
Area” on page 198 for the formal declarations. 


¢ Control Block Eye-catcher—This field is a 4-character string field that is supplied 


by DFDSS. It contains the character string E/DB and can be of use in locating 
the control block when you are viewing a storage dump during DEBUG proc- 
essing. - : 


TASK-ID—This field is a fullword binary field that is supplied by DFDSS. The 
number contained in this field is assigned by DFDSS to each function command 
statement submitted in SYSIN, whether obtained from the data set or from the 
UIM. This number is binary zero when DFDSS is calling the UIM for a func- 
tion that is not related to a user command statement. Each command is num- 
bered in sequence. When a task is scheduled to process this command, all 
messages associated with this task and all calls to the user interaction module for 
this task are accompanied by this unique number. In this way, the UIM can 
identify which task is being processed and what function is associated with that 
task. 


Installation Exit Allowance—this field is a fullword binary field supplied by ~~ 
DFDSS. The 32 bits defined in this field can be used as flags to determine what 
actions the UIM can perform with respect to the record presented. Some 
actions conditionally allowed are: 


— View and conditionally override the installation options. 

— Insert data prior to current record. 

— Replace the current data record with an exit-record supplied. 
— Delete the current data record. 

— Modify the current data record. 

— Disconnect the exit from further interaction. 

— Recognize when a disallowed option has been attempted. 

— End processing of the data set. 

~— End processing of the task. 


DFDSS Processing Option—This field is a halfword binary field that is supplied 
by DFDSS. The number contained in this field can be used by the user inter- 
action module (UIM) to vector branch to the appropriate processing routine for 
the record or data set being presented to the exit. 


At appropriate locations in the DFDSS processing modules, the user interaction 
module is considered for receiving control. These locations are referred to as 
DFDSS Exit Points. 


User Return Code—This field is a halfword binary field that is filled in by the 
UIM. The number contained in this field identifies the action expected by the 
exit on the record or data set being presented to the exit. This field is examined 
by DFDSS when control returns from the UIM. Although not all the following 
return codes are allowed at any given exit call, the list does include all accept- 
able return codes. If a code that is not allowed is returned from the UIM, 
DFDSS passes the EIDB back to the UIM with the EIXERR flag set. This 
allows the UIM one chance to correct the option. If a code that is not allowed is 
then returned again, it is ignored by DFDSS and the record is processed as 
though the exit had returned the code zero (0). This sequence is followed for 
any subsequent incorrect return codes. The meaning of each return code for 
those exits presenting records to the UIM (Eioptions | to 20) is: 


0 The record is processed as would normally have happened if there had not 
been a UIM. The original record is not changed in any way by the exit. 


Application Interface © 


4 The record was replaced by the exit. The new record must be placed in the 
area pointed to by the original record pointer field and its length stored in 
the original record length field. 


8 The record is to be inserted. The address of the new record must be stored 
in the original record pointer field or the new record must be stored in the 
area pointed to by the original record pointer field and its length must be 
stored in the original record length field. When this exit is next called, the 
original record is presented again. 


12 The record is to be deleted. The record presented to the UIM is ignored in 
the processing, thus deleting it. 


16 The record was modified by the exit. This return code is the only one 
allowing the original record to be altered and then to be processed by 
DFDSS. Any changes made to the record must be logically correct because 
DFDSS cannot assure the validity of these changes. 


Note: If the record being processed is the installation options record 
(ADRUFO) and any values have been changed, return code 16 must be 
returned or the changes are ignored. 


20 The record is to be processed as though a return code zero (0) had been 
given, but this particular DFDSS exit point will no longer be called from the 
current functional task, although it might be called from others. You must 
be cautious in using this code because multiple record types use the same 
DFDSS exit point. It would be better for the UIM to inspect each record 
type and only give a return code zero (0) when a record is not of interest to 
the exit. 


24 The record is to be processed but at all future visits of DFDSS at this exit 
point, only user statistical records are to be presented to the UIM. 


28 The notification-of-response return code. The WTOR has been handled by 
the UIM and the UIM has supplied the proper response from the WTOR in 
the area pointed to by the original record pointer. The interface allows you 
to handle all WTOR processing in the UIM exit routine and to supply the 
required response to DFDSS in lieu of DFDSS’s issuing the WTOR itself. 
Note that the UIM must set the original record length to the proper value. 


32 DFDSS ends the current functional task and issues message ADR356E. This 
return code is supported only for full volume DUMP and RESTORE. 


The meaning of each return code for those exits controlling data set processing 
(E1options 21, 22, and 23) is: 


Q The data set is processed as would normally have happened if there had not 
been a UIM. Data set processing is not altered in any way. 


16 This return code is valid from exit 22 only. It indicates to DFDSS to 
examine the bypass processing flags and to modify processing of the data set 
according to which flags are on. These bypass flags are only examined by 
DFDSS if a return code of 16 is returned. Refer to “Bypass Verification Exit 
(Eioption 22)” on page 194 for more details about these flags. 


20 The record is to be processed as though a return code zero (0) had been 
given, but this particular DFDSS exit point will no longer be called from the 
current functional task, although it might be called from others. You must 
be cautious in using this code because multiple record types use the same 
DFDSS exit point. It would be better for the UIM to inspect each record 
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type and only give a return code zero (0) when a record is not of interest to 
the exit. 


32 DFDSS ends the current functional task and issues message ADR356E. This 
return code is supported only for logical data set COPY, logical data set 
DUMP, and logical data set RESTORE. 


36 DFDSS ends processing of the data set named in the parameter passed to the 
exit. Processing continues with the next data set (if any). If Exit 23 sets this 
return code after the data set has already been processed, then DFDSS does 
not undo the processing, but deletes the data set from the successfully- 
processed message list (if applicable) and includes it in the unsuccessfully- 
processed message list even though the data set may have been successfully 
processed up to that point 


Record Area Length—This field is a fullword binary field that is supplied by 
DFDSS. The number contained in this field represents the total length of the 
area in which the original record is stored. The number can be used by the UIM 
to verify that replacement and inserted records will fit in the provided buffer 
area pointed to by the original record pointer field. The value of this field is 
zero (0) when the UIM is called by exits 21, 22, or 23. 


Original Record Length—This field is a fullword binary field that is supplied by 
DFDSS but can be changed by the UIM. The number contained in this field 
represents the total length of the record pointed to by the original record 
pointer. The length includes just the length of the record pointed to by the ori- 
ginal record pointer field and does not include the length of this field itself. The 
value of this field is zero when the UIM is called to supply in-storage SYSIN 
data. The value of this field is zero (0) when the UIM is called by exits 21, 22, 
or 23. 


Original Record Pointer—This field is a fullword address field that is supplied by 
DFDSS but can be changed by the UIM. This field contains the address of the 
record being passed to the UIM on this call. This address will normally not be 
changed by the exit unless an insertion is being used. Refer to the proper return 
code descriptions for the effect on this field. The value of this field is zero when 
the UIM is called to supply in-storage SYSIN data or called by Exits 21, 22, or 
23. The location of the original record, above or below the 16-megabyte (Mb) 
virtual storage line, is controlled by using the installation options exit. If this 
record is to be above 16 Mb, the UIM has to run in 31-bit addressing mode in 
order to address the record. 


User Area Pointer—This field is a fullword address field that is supplied by the 
application program and is maintained by DFDSS. This field contains the 
address of the user data/work area that was supplied by the application program 
as a Communications area for UIM internal process controls. DFDSS saves this 
pointer and supplies it in the ET\USEPTR field of the exit identification block on 
each call to the UIM. If any UIM exit changes the user area pointer, DFDSS 
presents the updated pointer on subsequent calls to the UIM. 


Each DFDSS functional task keeps its own copy of the user area pointer. If the 
pointer is changed by the UIM for one task, it does not be changed in any other 
task. At the beginning of each task, the user area pointer is the one passed to 
DFDSS by the application program. 
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¢ DDNAME/VOLID Pointer—This field is a fullword address field supplied by 


DFDSS. It contains the address of an area containing the DDNAME of the 
output dump data set, left-justified in an 8-byte area, followed by a 6-byte area 
containing the volume serial number of the volume containing the dump data 
set. also left-justified. This pointer is valid only for the full volume DUMP exit, 
EIOPO6. 


| Application Interface Descriptions 


Following are the descriptions for all of the exit points available with DFDSS. 


Function Startup (Eioption 0) 
This exit point is called when DFDSS starts a function such as DUMP or 
RESTORE. 


The valid return codes for function startup are: 


¢ 0 (continue normal processing) 
¢ 20 (inhibit all UIM calls) 
¢ 32 (end processing -- Only valid for a full DUMP and a full RESTORE). 


Reading SYSIN Record (Eioption 1) 3 
This exit point is called after DFDSS reads a SYSIN record. You can replace, 
insert, delete, or modify a SYSIN record at this exit point. The ETIRECPTR points 
to the SYSIN record. 


The valid return codes for reading SYSIN records are: 


0 (continue normal processing) 
4 (record replaced) 

8 (insert record) 

12 (delete record) 

16 (record modified) 

20 (disconnect exit). 


Printing SYSPRINT Record (Eioption 2) 
This exit point is called when DFDSS is ready to print a SYSPRINT record. You 
can replace, insert, delete, or modify a SYSPRINT record at this exit point. The 
EIRECPTR points to the SYSPRINT record. 


The valid return codes for printing SYSPRINT records are: 


0 (continue normal processing) 
4 (record replaced) 

8 (insert record) 

12 (delete record) 

16 (record modified) 

20 (disconnect exit). 


Note: When DFDSS is printing a page header record, you can only modify or 
delete the record. 
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Reading Physical Tape Record (Eioption 3) 
This exit point is called when DFDSS has read a record from a data set that has 
been dumped (on tape or DASD) by using the DUMP command. The EIRECPTR 


points to the tape record. The valid return codes for reading physical tape records 
are: 


¢ 0 (continue normal processing) 

¢ 8 (insert record—Only valid when UFNOIN is set in the user installation options 
exit). 

¢ 20 (disconnect exit) 

¢ 32 (end function—Only valid for a full DUMP and a full RESTORE). 


Reading Logical Tape Record (Eioption 4) 
This exit point is called when DFDSS has read a record from a data set which was 
created with a logical DUMP command and dumped on tape or DASD. The 
EIRECPTR points to the tape record. 


The valid return codes for reading logical tape records are: 


¢ 0 (continue normal processing) 

¢ 8 (insert record) 

° 20 (disconnect exit) 

¢ 24 (select user statistics records) . -_ . 

e 32 (end function—Only valid for a full DUMP and a full RESTORE). 


Note: If code 24 is returned, DFDSS will only call this exit point when DFDSS 
processes user statistics records. 


Writing Logicai Tape Record (Eioption 5) 
This exit point is called when DFDSS writes a logical record to a dumped dataset, 
on tape or DASD, while performing a logical DUMP. If you insert a record at this 
exit point, DFDSS marks it as a statistics record, not a data record. The 
EIRECPTR points to the tape record. 


The valid return codes for writing logical tape records are: 


¢ 0 (continue normal processing) 
¢ §8 (insert record) 
¢ 20 (disconnect exit). 


Writing Physical Tape Record (Eioption 6) 
This exit point is called when DFDSS writes a physical record to a dumped data set 
on tape or DASD. The EIRECPTR points to the tape record and the EIDDID 
points to DDINFO. 


The valid return codes for writing physical tape records are: 


¢ Q (continue normal processing) 

e 12 (delete record—Only valid when UFNOOUT is set in the user installation 
options Exit). 

¢ 20 (disconnect exit) 

e 32 (end function—Only valid for a full DUMP). 
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Reading Disk Track (Eioption 7) 
This exit point is called when DFDSS has read a track from DASD. The 
EIRECPTR points to the track buffer. 


The valid return codes for reading disk tracks are: 


¢ 0 (continue normal processing) 
¢ 20 (disconnect exit) 
e 32 (end function—Only valid for a full DUMP). 


Writing Disk Track (Eioption 8) 
This exit point is called when DFDSS is ready to write a track to DASD. The 
EIRECPTR points to the track buffer. 


The valid return codes for writing disk tracks are: 


¢ 0 (continue normal processing) 
¢ 20 (disconnect exit) 
¢ 32 (end function—Only valid for a full RESTORE). 


Reading Utility SYSPRINT (Eioption 9) 
This exit point is called when DFDSS is reading output from an attached utility. 
You can replace, insert, delete, or modify a utility SYSPRINT record at this exit 
point. The EIRECPTR points to the Utility SYSPRINT record. 


The valid return codes for reading utility SYSPRINT are: 


¢ 0 (continue normal processing) 
e 4 (record replaced) 

¢ 8 (insert record) 

e 12 (delete record) 

¢ 16 (record modified) 

¢ 20 (disconnect exit). 


Reserved (Eioption 10) 
This exit point is not currently used by DFDSS. 


Writing WTO Message (Eioption 11) 
This exit point is called when DFDSS is ready to write a WTO message which was 
specified in the SYSIN. You can replace, insert, delete, or modify the WTO message 
at this exit point. The ETRECPTR points to the WTO message. 


The valid return codes for writing WTO messages are: 


¢ 0 (continue normal processing) 
* 4 (record replaced) 

¢ 8 (insert record) 

e 12 (delete record) 

e¢ 16 (record modified) 

¢ 20 (disconnect exit). 
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* For each component or data set: 
— The number of volumes it resides on 
— The volser of each volume 
— The RBA of the control interval in the VVDS of the VVDS entry of each 
volume. 


EIRECPTR points to ETREC20. E20DA@ and EROIX®@ point to EI20DSI. 


Note: Because SMS-managed multivolume non-VSAM data sets have a VVDS 
entry only on the first volume, RBA information is passed for just one volume. The 
RBA in all other volume entries will be zero. Likewise, the RBA information for 
non-SMS-managed non-VSAM data sets will always be zero. 


The valid return codes for volume notification are: 


¢ 0 (continue normal processing) 

e 20 (disconnect exit) 

e 32 (end function—Only valid for full or physical data set DUMP and full or 
physical data set RESTORE). 


Data Set Verification (Eioption 21) 
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This exit allows the user interaction module (UIM) to end logical COPY, DUMP, 
and RESTORE processing for individual data sets. This exit is given control 
through the UIM at the start of logical COPY, logical DUMP, and logical 
RESTORE processing for each data set. DFDSS provides the UIM with the data 
set name through the EIREC21 structure within the exit identification block, 
ADREIDO. EIREC21 is shown in Figure 27 on page 197. The name provided is 
the original data set name prior to rename processing, if any, for COPY and 
RESTORE. The UIM returns to DFDSS with a return code in the exit identifica- 
tion block. 


The valid return codes for data set verification are: 


¢ 0 (continue normal processing) 
¢ 20 (disconnect exit) 

¢ 32 (end function) 

¢ 36 (end data set) 


DFDSS will continue processing with the next data set, if any. If the user speci- 
fies the SPHERE keyword and processing for a base cluster is ended through 
this exit, processing for all AIXs related to the base cluster is also ended. If the 
user specifies the SPHERE keyword and the UIM attempts to end processing for 
an AIX that is related to a base cluster that was selected for processing, DFDSS 
invokes the UIM again. If the UIM attempts to end processing for the AIX 
again, DFDSS issues warning message ADR770W and ignores the request. If 
the user does not specify the SPHERE keyword, AIXs can be ended even if they 
are related to base clusters selected for processing. Ending a base cluster 
without the SPHERE keyword does not cause any related AIXs to be ended. 


Note: See the Note for Eioptions 21, 22, 23 on page 194. 
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| Bypass Verification Exit (Eioption 22) 

| This exit allows a user to force DFDSS to bypass serialization and security verifica- 
| tion during logical COPY, DUMP, and RESTORE processing for individual data 

| sets. It also allows a user to turn on a tolerate-migrated-volser indicator that forces 
| DFDSS ‘to restore a data set with a migrated voiser. This exit is given control 

| through the UIM at the start of logical COPY, logical DUMP, and logical 

| RESTORE processing for each data set. DFDSS provides the UIM with the data 

| set name through the EIREC22 structure within the exit identification block, 

| ADREIDO. EIREC22 is shown in Figure 27 on page 197. The data set name pro- 
| vided is the original name prior to rename processing, if any, for COPY or 

| RESTORE. The UIM returns to DFDSS with a return code in the exit identifica- 

| tion block. 


The valid return codes for data set verification are: 


| ¢ 0 (continue normal processing) 
| ¢ 16 (bypass one or more of the following:) 


| — Serialization via ENQ or SVC 99 is bypassed if the UIM exit turns on the 

| bypass serialization indicator, El22BSER. Serialization is bypassed for the 

| source data set for COPY and DUMP. Serialization is also bypassed for the 
| target data set for COPY and RESTORE. DFDSS assumes that all neces- 

| sary serialization has already been performed by the invoker of DFDSS. 
However, DFDSS does no checking to ensure that this is true. DFDSS per- 
| forms normal serialization if the UIM exit does not turn on the bypass 

| serialization indicator. 


| DFDSS does not delete or uncatalog data sets that were bypassed for serial- 
| ization even if the DELETE or UNCAT keywords are specified. If a preal- 
located data set is not large enough during a data set RESTORE and the 
Dv pass Serialization indicator is on, DFDSS does not scratch and reallocate 
that target data set and the RESTORE fails. 


— RACF verification and all other data set security checking is bypassed if the 

UIM exit turns on the bypass RACF indicator, EI22BSEC. If EI22BSEC is 
set on, DFDSS checks to ensure that the application program is authorized 
io bypass RACF and security processing. The application program 1s 
authorized to bypass RACF and security processing if the JSCBPASS flag is 

on in the job step control block. If the EIZ22BSEC and JSCBPASS indica- 

| tors are on, RACF verification and all other data set security processing 

including password checking is bypassed. DFDSS does not do any RACF 
authorization checks. DFDSS does not create any RACF profiles for the 
copied or restored target data set. DFDSS assumes that all necessary 
RACF authorization and security checking has already been performed by 
the invoker of DFDSS. Fora COPY or RESTORE operation, RACF pro- 
files are not created for the target data set. 


If the user turns on the bypass RACF indicator and the JSCBPASS indi- 
cator is off, DFDSS sets the error flag, EIXERR, on in the exit identifica- 
tion block and invokes the UIM again. If the user sets the bypass RACF 
| indicator again, DFDSS issues error message ADR772W and processing 
continues as normal. DFDSS does still allow serialization to be bypassed 
and tolerate migrated volser processing if those indicators are set. 


DFDSS performs normal RACF and security processing if the UIM exit 
does not turn on the bypass RACF indicator. 


— Ifthe tolerate-migrated-volser indicator is set on by the UIM, DFDSS takes 
special action to support the restoration of a non-VSAM data set with a 
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volser of MIGRAT for a logical data set RESTORE operation in an SMS 
environment or when CATALOG has been specified. DFDSS ignores the 
EI22BMIG indicator for COPY and DUMP operations and VSAM data 
sets. 


When DFDSS is restoring a non- VSAM data set and the tolerate-migrated- 
volser indicator is set on, a catalog LOCATE is issued to determine the 
status of the data set being restored. Based on the result of that LOCATE, 
different actions will be taken. 


— No catalog entry is found: In this case, the data set being restored is not 
considered to be migrated. A normal DFDSS logical restore is per- 
formed. The tolerate-migrated-volser indicator is ignored. 


— A catalog entry is found, but the VOLSER is not MIGRAT: Again, the 
data set is not considered to be migrated. As above, normal processing 
continues as though the indicator had not been set. 


— A catalog entry is found and the VOLSER is MIGRAT: The data set is 
indeed migrated and requires special processing. Instead of cataloging 
the data set after aliocating it, DFDSS alters the existing MIGRAT 
volser entry to the actual volume the data set was restored to. Once the 
catalog entry has been changed from MIGRAT to the new data set’s 
volsers, the restore continues as normal. 


- Note: - Because the migrated data set is not recalled during this restore, 
the user of this interface is responsible for deleting the migrated copy of 
the data set and updating the necessary control files. 


DFDSS performs normal non-VSAM data set cataloging if the UIM exit 
does not turn on the tolerate-migrated-volser indicator. 


If the LIM exit sets the return code to EIRC16 but fails to turn on any of the 
bypass verification indicators, DFDSS ignores all bypass options and performs 
normally. If the UIM exit sets the return code to EIRC16 for a VSAM data set 
and turns on the tolerate-migrated-volser indicator, DFDSS does not treat it as 
an error condition and ignores the tolerate-migrated-volser indicator. 


¢ 20 (disconnect exit) 
e¢ 32 (end function) 
¢ 36 (end data set). 


Refer to EIRC36 in “Data Set Verification (Eioption 21)” on page 192 for 
details on ending spheres. 


Note: See the Note for Eioptions 21, 22. 23 on page 194. 


Data Set Processed Notification Exit (Eioption 23) 
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This exit indicates to the UIM whether or not the logical COPY, DUMP. or 
RESTORE processing for individual data sets was successful. This exit is given 
control through the UIM at the conclusion of logical COPY, logical DUMP, and 
logical RESTORE processing for each data set. DFDSS provides the UIM with 
information through the EIREC23 structure within the exit identification block, 
ADREIDO. EIREC23 is shown in Figure 27 on page 197.. 


DFDSS provides the UIM with the following information at the conclusion of proc- 
essing for logical DUMP of each data set: 


e The data set name that was dumped. 
e A return code for the data set that indicates whether processing was successful. 





Application Interface 


— 0 (Data set completely successful (informational)) 

— 4 (Data set partially successful (warning)) 

— 8 (Data set unsuccessful (error)) 

— 12 (Ending error) 

— {6 (Ending error) 

The source SMS flag (DSISMSFG) from the Format | DSCB. 

The source data set organization (DS1DSORG) from the Format 1 SGP fora 
non-VSAM data set. 

Flags to indicate data set tvpe for a VSAM data set. 


DFDSS provides the UIM with the following information at the conclusion of proc- 
essing for logical COPY and logical RESTORE of each data set: 


The original data set name that was copied or restored. This is the data set 
name prior to rename processing, if any. 

The new data set name being copied or restored if rename processing was per- 
formed. 

A return code for the data set that indicates whether processing succeeded: 

— Q Data set completely successful (informational) 

— 4 Data set partially successful (warning). ; : 

— §& Data set unsuccessful (error) 

— 12 Ending error 

— 16 Ending error 

The source and target SMS flags (DSISMSFG) from the Format 1 DSCB. 
The source and target data set organization (DSIDSORG) from the Format 1 
DSCB for a non-VSAM data set. . 
Flags to indicate data set type for a VSAM data set. 

A count of the volumes that the data set was copied or restored to. 

A list of the volume serizi numbers (VOLSERs) that the data set was copied or 
reswored tc. 


The UIM returns to DFDSS with a return code in the exit identification block. The 
valid return codes for data set verification are: 


0 (continue normal processing) 
20 : disconnect exit) 

32 (end Function) 

36 ‘end data set) 


It does not undo anv successful processing, but deletes the data set from the 
successfully-processed message list (if applicable) and includes it in the 
unsuccessfully-processed message list. It is the responsibility of the user of this 
interface to delete the cepied. dumped. or restored data set from the target 
volumes. DFDSS continues processing with the next data set, if any. Refer to 
EIRC36 in “Data Set Verifeation (Eioption 21)” on page 192 for details on 
endixg spheres. 


Note for Eioptions 21, 22, 23: If Etoptions 21. 22. and 23 end the function (the User 
Interaction Module (UDM) passes back a return iesde 32 to DFDSS) during data set 
COPY. DFDSS can be processing mere than one data set at the time. This can 
happen if utilities are needed to process some of the data sets. DFDSS does the 
following steps before ending: 


No unprocessed data sets are scheduled for processing. 

All data sets in utility processing are allowed to complete normally. 

No new calls are made to exits 21, 22. or 23. This includes data sets in utility 
processing that are allowed to complete. 
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e Spheres that are being processed because of the SPHERE keyword and that are 
not complete at the end of the function will have the target parts deleted to pre- 
serve sphere integrity. Preallocated spheres are left partially copied. 

e Spheres being processed without the SPHERE keyword or individual sphere 
components being copied are left partially completed. 


Avoiding Lockout 


Refer to “Avoiding Lockout” on page 166 for a description of the ENQ scheme to 
prevent lockout. 


Application Interface Summary 


Record Processing: If the UIM makes any changes to the presented record 
(assuming it can validly do so), return code 16 must be returned or the changes are 
ignored. If the record is to be replaced in total, return code 4 must be returned or 
the original record is used. Ifa record is to be inserted before the current record, 


_return code 8 must be returned or the record is ignored. If the current record is to 
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be deleted. return code 12 must be returned or the current record is processed. If the 
exit is no longer interested in processing any records appearing at the current 
DFDSS exit point, return code 20 must be returned or the exit is called at the next 
visitation of DFDSS to the exit point. The current record will still be processed in | 
either event. If you want to receive only user statistical records at any specific exit, 
return code 24 must be returned. If you want to process a WTOR within the UIM, 
the response must be returned to DFDSS with a return code 28. 


Tf a record is being returned that is longer than the original record, the exit must 
either replace the record in the area pointed to by the original record pointer or 
supply another area and store the address to the record in the original record pointer 
field. In either case, the length must be stored in the original record length field and 
a return code of 4 must be used. If a record is being returned that is shorter than 
the original record, the exit can supply an area and store the address to the record in 
the origina! record pointer field or, if allowed, can merely replace the original record 
with the shorter one. In either case, the length of the new record must be placed in 
the original record length field. If the new area option was used, return code 4 must 
be used. Ir the new record overlaid the original, return code 16 must be used. 
Figure 27 on page 197 describes the data area corresponding to the DFDSS exit 
identification block. 


Data Set Processing: Eioptions 21, 22. and 23 are three exits that give you added 
control over data set processing during a logical data set COPY, DUMP, and 
RESTORE. These exits are called immediately prior to and immediately after each 
data set’s being processed, on a data set by data set basis, and allow you to make a 
number of processing changes. 


Eioptions 21 and 22 are called, one after the other, at the start of processing of each 
data set. DFDSS passes each exit the name of the data set being processed. Based 
on that name, each exit allows you to end processing of just that data set (return 
code 36); end processing of the whole functional task (return code 32); disconnect 
the exit so that it is no longer called prior to subsequent data sets being processed by 
that task (return code 20); or do nothing (return code 0). Eioptions 22 also allows 
you to modify the way in which the data set 1s to be processed (return code 16). 
Refer to “Bypass Ver. fication Exit (Eioption 22)” on page 193 for more details. 
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Eioption 23 is called immediately after a data set has been processed and also allows 
you to end processing of the data set, end processing of the task, disconnect the exit, 
or do nothing. 


ADREIDO Data Area 


The following figures describe the data area corresponding to the DFDSS exit iden- 
tification block. 


Figure 27 (Page 1 of 3). ADREIDO Mapping Macro 








Offsets Type Length Name Description 
0 (0) CHARACTER 42 ADREIB 
0 (0) FIXED 2 EIDLLEN LENGTH OF ADREIB 2 
2 (2) CHARACTER 4 EIID BLOCK IDENTIFIER EBCDIC “EIDB’” 
6 (6) FIXED 4 EITSKID TASK ID NUMBER 
10 (A) BITSTRING 4 EIXALLOW USER EXIT ALLOWANCE OPTIONS 
10 (A) BITSTRING I EIXALOWO ALLOWANCE OPTION BYTE 1 
ae EIXREP ALLOW REPLACE OF RECORD 
+ re EIXINS ALLOW INSERTION OF RECORD 
wiki EIXDEL ALLOW DELETION OF RECORD 
tak, “oses? EIXMOD ALLOW MODIFICATION OF RECORD 
te, Pros EIXDIS ALLOW DISCONNECT OF EXIT 
Aka EIXWTOR ALLOW WTOR RESPONSE 
sols EIXSTAT ALLOW SELECTION OF USER STATS 
Lore veeal EIXTERM ALLOW FUNCTION ENDING 
il (B) BITSTRING 1 EIXALOWI ALLOWANCE OPTION BYTE 2 
tae! ess EIXTDSET ALLOW DATA SET ENDING 
slid “1101 * UNUSED 
12 (C) BITSTRING 1 EIXALOW2 ALLOWANCE OPTION BYTE 3 
12 (C) BITSTRING 1 * RESERVED 
13 (D) BITSTRING ! EIXALOW3 ALLOWANCE OPTION BYTE 4 
bic uae EIXERR DISALLOWED OPTION ATTEMPTED 
te. TiN * RESERVED 
| 14 (E} FIXED 2 EIOPTION PROCESSING OPTION 
16 (10) FIXED 2 EIRETCOD EXIT RETURN CODE : 
! 18 (12) FIXED 4 EIRECALN RECORD AREA LENGTH 
| 22 (16) FIXED 4 EIRECLEN ORIGINAL RECORD LENGTH 
26 (1A) ADDRESS 4 EIRECPTR ORIGINAL RECORD ADDRESS 
30 (1E) ADDRESS 4 EILSEPTR USER DATA AREA ADDRESS 
| 34 (22) ADDRESS 4 EIDDID EIOP06 DDNAME WOLID PTR 
38 (26) BITSTRING 4 EIXFLAGS OTHER FLAGS 
38 (26) BITSTRING 1 EIXFLAGO FLAG BYTE 0 
ede iia, EIXABEND FOR EIOP02 ONLY. |! =MESSAGE IS ADROL3 INDICATING | ! 
AN ABEND CONDITION 
vfs EIXNTERR FOR EIOP02 ONLY. | = MESSAGE IS TYPE ‘E’ AND IS NOT 
324 OR 347 
ett. TT * RESERVED 
39 (27) BITSTRING 1 EIXFLAGI FLAG BYTE 1 
39 (27) BITSTRING l * RESERVED 
| 40 (28) BITSTRING 1 EIXFLAG2 FLAG BYTE 2 
40 (28) BITSTRING 1 * RESERVED 
fl (29) BITSTRING { EIXFLAG3 FLAG BYTE 3 
i dt (29) BITSTRING l * RESERVED | 
42 (2A) CHARACTER * FORCE SIZE OF CONTROL BLOCK TO WORD 
| BOUNDARY 
9 (0) CHARACTER 6 EIDDINFO CIM 06 INFO 
| 0 (0) CHARACTER 8 EIDDNAME O P DEVICE DDNAME 
8 (8) CHARACTER 6 EIVOLID O-P VOLSER 
14 (E) FIXED 1 EIRETC RESERVED FOR RETCODE 
15 (F) FIXED \ * RESERVED FOR FLAGS 
0 (0) CHARACTER 56 EIREC20 
0 (0) CHARACTER 4 EI20DSN DATA SET NAME CLUSTER NAME 
44 (2C) BITSTRING l EI20FLGS SOME FLAGS 
is FI20VSAM 1=DATA SET IS VSAM 0=DATA SET IS NONVSAM 
ae, EI20RACF 1=DATA SET IS PROTECTED BY A DISCRETE RACF 
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45 
45 


46 


48 








95 
95 


(2D) 
(2E) 
(2F) 
(30) 


(34) 


(0) 
(0) 
(2C) 
(2E) 
(30) 
(30) 
(36) 
(38) 
(0) 
(0) 
(0) 
(0) 
(2C) 


(2D) 
(2D) 


(2E) 


(30) 


(0) 
(0) 
(2C) 
(58) 
(SA) 
(5A) 


(5B) 


(5D) 


(SF) 
(SF) 


eell 1111 
CHARACTER 
FIXED 
FIXED 
ADDRESS 


ADDRESS 


CHARACTER 
CHARACTER 
FIXED 
CHARACTER 
CHARACTER 
CHARACTER 
CHARACTER 
FIXED 
CHARACTER 
CHARACTER 
CHARACTER 
CHARACTER 
BITSTRING 


ole. weee 


esee L111 


CHARACTER | 


CHARACTER 
CHARACTER 


BITSTRING 


Vads., sities 
1 
dias 


weed 


-lli 1111 
CHARACTER 
CHARACTER 
CHARACTER 
FIXED 
CHARACTER 
CHARACTER 


CHARACTER 


BITSTRING 
Less 
ode 
sos 
; 


ook 


elll) iil 
CHARACTER 
CHARACTER 
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Length 


60 


rn 
BR 


~EASERanvnadsnn 


1s 
b 


fa 


Name 


EI20DA# 
EI201X# 
EI200DA@ 


EI20IX@ 


EI20DSI 
EI20CON 
EI20NVOL 
* 

EI20VLI 
EI20VOL 

* 


ERORBA 
EIREC21 
EI21DSN 
EIREC22 
EI22DSN 
EI22FLGS 
EI22BSER 
EI22BSEC 


EI22BMIG 


EJ22BFBU 
* 

EI22SFLG 
E22SSMSF 


E22SDSRG 


E22SVFLG 
E22SESDS 
E225KSDS 
E22SKRDS 
E22SLDS 
E22SRRDS 
E22SPSSI 


E228SVYDS 
E22SBCS 
E22SAIXK 

* 


EIREC23 
EI23DSN 


ER3INEWN 


EI23DSRC 
EI23SFLG 
E23SSMSF 


E23SDSRG 


23SVFLG 
E23SESDS 
E23SKSDS 
E23SKRDS 
E23SLDS 
E23SRRDS 
E23SPSSI 


E23SVVDS 
E23SBCS 
E23SAIX 

* 
EI23TFLG 
E23TSMSF 


Description 





RESERVED 

RESERVED 

NUMBER OF DATA COMPONENTS 

NUMBER OF INDEX COMPONENTS (0 IF NONVSAM) 
POINTER TO DATA COMPONENT INFO FOR VSAM/DATA 
SET INFO FOR NONVSAM 

POINTER TO INDEX COMPONENT INFO FOR VSAM/0 
FOR NONVSAM 

DATA SET INFO 

COMPONENT NAME (BLANKS FOR NONVSAM) 

# OF VOLUMES IN DS 

RESERVED 

VOLUME INFORMATION 

VOLSER 

RESERVED 

RBA OF VVDS ENTRY/0 IF NONE 


DATA SET/CLUSTER NAME 


DATA SET/CLUSTER NAME 
EXIT 22 FLAGS 
1=BYPASS ENQ/SVC 99 SERIALIZATION 
1=BYPASS SECURITY CHECKING RACF FROFIEE oe 
ATION - 
1=TOLERATE MIGRATED VOLSER FOR NONVSAM 
DSETS (RESTORE ONLY) 
RESERVED 
RESERVED 
SOURCE DATA SET FLAGS 
SOURCE SMS FLAGS (DSISMSFG) FROM FORMAT 1 
DSCB 
SOURCE DATA SET ORG(DSIDSORG) FROM FORMAT |! 
DSCB 
SOURCE VSAM DSET FLAGS 
1=ESDS DATA SET 
:=KSDS DATA SET 
!=KRDS DATA SET 
i=LINEAR DATA SET 
i=RRDS DATA SET 
=PAGE/SWAP STGINDEX, ETC. UNSUPPORTED DATA 
SETS 
=VVDS DATA SET 
=BCS DATA SET 
1=AIX DATA SET 
RESERVED 





DATA SET CLUSTER NAME 

NEW DSET CLUSTER NAME 

RETURN CODE FOR DATA SET PROCESSING 
SOURCE DATA SET FLAGS 

SOURCE SMS FLAGS (DSISMSFG) FROM FORMAT 1 
DSCB 

SOURCE DATA SET ORG(DS!1DSORG) FROM FORMAT 1 
DSCB 

SOURCE VSAM DSET FLAGS 

1 =ESDS DATA SET 

1=KSDS DATA SET 

1=KRDS DATA SET 

i =LINEAR DATA SET | 
L=RRDS DATA SET 

1 =PAGE/SWAP STGINDEX, ETC. UNSUPPORTED DATA 
SETS 

1=VVDS DATA SET 

1=BCS DATA SET 

1 =AIX DATA SET 

RESERVED 

SOURCE DATA SET FLAGS 

SOURCE SMS FLAGS (DSISMSFG) FROM FORMAT 1 
DSCB 
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Offsets 


96 


98 


100 
101 


(60) 


(62) 


(64) 
(65) 


Type 


er 
sles. 
ol. 
cool 


BITSTR 


ING 


CHARACTER 


ale 


oaks 


l... 
lll 
FIXED 


Figure 28. Constants 


Length 
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Type 


CHARACTER 


DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 
DECIMAL 


eoel 


11t1 


CHARACTER 


O WOAH NH & WP — © 


ae er ro ra ey 
SNM hw ty © 


Length 
2 


2 


t 
6 


Name 


E23TDSRG 


E23TVFLG 
E23TESDS 
E23TKSDS 
E23TKRDS 
E23TLDS ~ 
E23TRRDS 
E23TPSSI 


E23TVVDS 
E23TBCS 
E23TAIX 

* 


EI23VOL# 


EI23VSER (*) 


Name 


ADREIBID 


EIRC0O 
EIRC04 
EIRCO08 
EIRC12 
EIRCI6 
ETRC20 
EIRC24 
EIRC28 
EIRC32 
EIRC36 
EIOPOO 
EIOPOL 
EIOPO2 
EIOPO3 
EIOP04 
EIOPO5 
EIOP06 
EIOPO7 
EIOPO08 
EIOPO9 
EIOPI0 
EIOPtt 
EIOP12 
EIOP13 
EIOPI4 
EIOPI5 
EIOPI6 
EIOP(7 
EIOP18 
EIOPI9 
EIOP20 
EIOP21 
EIOP22 
EIOP23 
EIDBLEN 
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Description 


SOURCE DATA SET ORG(DSIDSORG) FROM FORMAT 1 
DSCB 

TARGET VSAM DSET FLAGS 

1=ESDS DATA SET 

1=KSDS DATA SET 

1=KRDS DATA SET 

1=LINEAR DATA SET 

1=RRDS DATA SET 

1 =PAGE/SWAP/STGINDEX, ETC. UNSUPPORTED DATA 
SETS 

1=VVDS DATA SET 

1=BCS DATA SET 

1=AIX DATA SET 

RESERVED 

NUMBER OF VOLUMES 

VOLSER ARRAY 


Description 


BLOCK IDENTIFIER 
CONTINUE NORMAL PROCESS 
RECORD REPLACED 

INSERT RECORD 

DELETE RECORD 

RECORD MODIFIED 
DISCONNECT EXIT 

SELECT USER STATS RECS 
WTOR RESPONSE 

END FUNCTION 

END DSET ONLY 

FUNCTION STARTUP ENTRY 
READING SYSIN RECORD 
PRINTING SYSPRINT RECORD 
READING PHYSICAL TAPE 
READING LOGICAL TAPE 
WRITING LOGICAL TAPE 
WRITING PHYSICAL TAPE 
READING DISK TRACK 
WRITING DISK TRACK 
READING UTILITY SYSPRINT 
WRITING UTILITY SYSPRINT 
WRITING WTO MESSAGE 
WRITING WTOR MESSAGE 
PRESENTING ADRUFO REC 
FUNCTION ENDING 
PRESENTING WTOR RESPONSE 
TAPE VOL SECURITY 

TAPE MOUNT(NON SPEC) 
INSERT LOGICAL REC 

TAPE OUTPUT ERROR 
VOLUME NOTIFICATION 

DSET VERIFICATION | 
BYPASS VERIFICATION 
DS PROC NOTIFICATION 
LENGTH OF BLOCK 
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Name Hex Struct Name Hex Struct 
Offset Level Offset Level 

ADREIB 0 1 E22SPSSI 30 4 

EIDDID 22 2 E22SRRDS 30 4 

EIDDINFO 0 1 E22SSMSF 2D 3 

EIDDNAME 0 2 E22SVFLG 30 3 

EIDLLEN 0 2 E22SVVDS 30 4 

EIID 2 2 E23SAIX SE 4 

EIOPTION E 2 E23SBCS SD 4. 

EIRECALN 12 2 E23SDSRG 5B 3 

EIRECLEN 16 2 E23SESDS 5D 4 

EIRECPTR 1A 2 E23SKRDS 5D 4 

EIREC20 0 1 E23SKSDS 5D 4 

EIREC?2} 0 1 E23SLDS 5D 4 

EIREC22 0 1 E23SPSSI 5D 4 

EIREC23 0 l E23SRRDS sD 4 

EIRETC E 2 E23SSMSF SA 3 

EIRETCOD 10 2 E23SVFLG 5D 3 

EITSKID 6 2 E23SVVDS 5D 4 

EIUSEPTR 1E 2 E23TAIX 63 4 

EIVOLID 8 2 E23TBCS 62 4 

EIXABEND 26 4 E23TDSRG 60 3 

EIXALLOW A 2 E23TESDS 62 4 

ELXALOWO0 A 3 E23TKRDS 62 4 

EIXALOWIL B 3 E23TKSDS 62 4 

EIXALOW2 Cc 3 E23TLDS 62 4 

EIXALOW3 D 3 E23TPSSI 62 4 

EIXDEL A 4 E23TRRDS 62 4 

EIXDIS A 4 E23TSMSF 5F 3 

EIXERR D 4 E23TVFLG 62 3 

EIXFLAGS 26 2 E23TVVDS _ 62 4 

EIXFLAGO 26 3 

EIXFLAG1 27 3 

EIXFLAG2 28 3 

EIXFLAG3 29 3 

ELXINS A 4 

EIXMOD A 4 

EIXNTERR 26 4 

EIXREP A 4 

EIXSTAT A 4+ 

EIXTDSET B 4 

EIXTERM A 4 

EIXWTOR A 4 

EI20CON 0 2 

EIZ0DA# 2E 2 

EI20DA@ 30 2 

EI20DSI 0 1 

EI20DSN 0 2 

EIZ0FLGS 2C 2 

EI201X# 2F 2 

EI20IX@ 34 2 

EI20NVOL 2C 2 

EI20RACF 2C 3 

EI20RBA 38 3 

EI20VLI 30 2 

EI20VOL 30 3 

EIZ0VSAM 2C 3 

EI21DSN 0 2 

EI22BFBU 2C 3 

EI122BMIG 2C 3 

E[22BSEC 2C 3 

EI22BSER 2C 3 

EI22DSN 0 2 

EI22FLGS 2C 2 

EI122SFLG 2D 2 

EI23DSN 0 2 

EI23DSRC 58 2 

EI23NEWN 2C 2 

EI23SFLG SA 2 

EI23TFLG 5F a 

EI23VOL# 64 2 

EI23VSER 65 2 

E22SAIX 31 4 

E22SBCS 30 4 

E22SDSRG 2E 3 

E22SESDS 30 4 

E22SKRDS 30 4 

E22SKSDS 30 4 

E22SLDS 30 4 
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An Example of Invoking DFDSS by Using an Application Program 


The following example shows that a full DASD volume is to be dumped to a tape 
volume(s). DFDSS is LINKed somewhere in MYJOB to perform the DUMP, and, 
conditionally, the DEFRAG functions. 


//30B1 JOB accounting information,REGION=nnnnKk 
//STEPI EXEC PGM=MYJOB 
//STEPLIB OD DSN=MY.LINKLIB,DISP=SHR 
//SYSPRINT DO SYSOUT=A 
//DASD DD UNIT=3380, VOL=(PRIVATE,SER=111111) ,DISP=O0LD 
//TAPE DD UNIT=3480, VOL=SER=(TAPEO1, TAPEQ2) , 
// LABEL=(1,NL) ,DISP=(NEW,KEEP) 
//SYSIN DD . 
DUMP INDD(DASD) OUTDD(TAPE) 

IF LASTCC = Q - 

THEN DEFR DDN(DASD) 

/* 


The preceding example does not show how the invocation of DFDSS was brought 
about, but does show that the user program, MYJOB, was run. Somewhere within 
MYJOB it is desired to run DFDSS to perform the functions specified in the SYSIN 
data set. At this point, the next example shows the necessary code used to LINK to 
DFDSS. Because no EXEC PARMs were specified and the standard SYSIN and 
SYSPRINT data set names are to be used, there is no need to pass special parame- 
ters. 


LINK EP=ADRDSSU,PARAM=(OPTPTR) ,VL=1 


CNOP 2,4 
OPTPTR OC  H(Q) 


Note: For additional information on the Application Interface, see Appendix D, 
“Examples of the Application Program with the User Interaction Module (UIM)” on 
page 203 


How to Determine DFDSS Version, Release, and Modification Level 
Subsystems that invoke DFDSS dynamically need to know if DFDSS is installed on 
the system, and if it is, its version, release, and modification level. A 
DFDSS-provided macro attempts to load the DFDSS load module. If the load ts 
successful, it determines the DFDSS version, release, and modification level and 
passes the requested information in a register. The macro also causes the load 
module to be deleted from main storage. 


ADRMCLVL (in SYSI1.SAMPLIB) is an in-line executable assembler-language 
macro that can be invoked by a caller. The caller can be in problem program state 
and have a user key. The caller must save registers 0, 1, 14. and 15 before invoking 
the macro. No other registers are disturbed. 
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Ree ea, oe pe oe eT : wee en 


On return, register 1 contains information as follows: 


¢ Ifthe release level of ADRDSSU cannot be determined, register 1 contains 
X'04000000'. 


¢ Otherwise, register 1, byte 0 contains X'00', and the three low-order bytes 
contain: 


Byte 1: Version number (in binary) .~ - 
1 = Version 1 
2 = Version 2 


Release number (in binary) 
Release 1 
Release 2 
Release 3 
Release 4 
Release 5 


Byte 


2 
1 
2 
3 
4 
5 


Modification level (in binary) 


Byte 3: 
0 = Modification level 0 
J 
2 


= Modification level 1 
= Modification level 2 


Figure 29 shows the expansion of the macro ADRMCLVL. | 





MACRO 

ADRMCLVL 
| LOAD EP=ADRRELVL, ERRET=ADRI&SYSNDX 
! 1R «1,8 

= 1,9(2) 

3 ADRZ3S/SNDX 

2TRL&SYSNOX LA 2,4/9,0) 

SLL 1,24 (9) 
B ADR3&SYSNDX 
DELETE EPSADRRELYL 


* register 1 contents: 

= byte 9: 0 if no errors, 4 otherwise 

= byte i: version number (0 if errors or indeend) 

© byte 2: release number (0 if errors or indeend) 

x byte 3: modification number (0 if errors or indeend) 


Om 





Figure 29. Expansion of Macro ADRMCLVL 


UIM 


Appendix D. Examples of the Application Program with the 
User Interaction Module (UIM) 












Application 
Program 


Note: The example shown is not written in reentrant code. If you are planning to 
share a UIM between tasks, you should code the module in reentrant code. 


The example has not been submitted to any formal test and is distributed as it is, 
without any warranty either expressed or implied. The use of this example or the 
implementation of any of these techniques is a customer responsibility and depends 
on the customer’s ability to evaluate and integrate them into the customer’s opera- 
tional environment. Although each item may have been reviewed by IBM for accu- 
racy in a specific situation, there is no guarantee that the same or similar results will 
be obtained elsewhere. Customers attempting to adapt these techniques to their own 
environment do so at their own risk. See Figure 31 on page 204 and Figure 32 on 
page 206 for a complete sample program listing showing how a user might use all of 
the UIM exit functions to receive control from DFDSS. Figure 33 on page 218 
shows what an output listing might look like as the result of the sample program in 
Figure 31 on page 204 and Figure 32 on page 206. 














ADRDSSU Calis UIM 


Read Sysin Exit 
Exit Functions . 


Write Logical Tape Exit 


i 


Function Termination Exit 





Figure 30. The Application Program Process 
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will pass these records to DFDSS. 


* * 
* Hodule Name = USRATPGM ‘ 
* Descriptive Name = DFDSS Application Interface Program ean i 
i ge 3 for the. Reference Guide. - fe 
‘ Function = Invoke DFDSS supplying alternate UIM: USRUIM * 
: Operation = Place SYSIN records in the Userarea. The UIM : 
* * 


HARRI IR IIR KIA II IIR IER III IRIS II IIIA IARI ISAS IIA IRI IIA RIE IAI 
USRAIPGM CSECT 

USRAIPGM AMODE 31 

USRAIPGM RMODE ANY 

* 


STM 14,12,12(13) 


BALR 12,0 

USING *,12 

LA 3, SAVEAREA 

ST 3,8 (13). 
“ST 13,4(3) 

LR 13,3 


LOAD EP=ADRDSSU 





LR 15,0 
LA 3 ,USERAREA 

| ST 3, UAG 

CALL (15). (OPTPTR,DONPTR, PAGEPTR,UIMPTR,UAPTR) ,VL 
L 13,4(13) 

| RETURN (14,12°, ,RC=(15) 

! * 


| CNOP 2,4 
P“OPTPTR. DC AL2(OPTLEN) 
OPTIONS OC C'SIZe=4096K' 
QOPTLEN EQU  *-OPTIONS 
CNOP 2,4 
DDNPTR DC AL2 (DONLEN) 
| DDNAMES DC XL8'00' 


DC XL8'00Q' 
BC XL8' CC" 
DC XL8' OC 


OC CL8'MYCATA! 
DC CL8'SYSPRINT! 
DONLEN EQU  *-DDNAMES 
CNOP 2,4 
PAGEPTR DC AL2 (PAGELEN) 
PAGENO DC CL4'0100' 
PAGELEN EQU *-PAGEPTR 





CNOP 2,4 
UIMPTR DC AL2(UIMLEN) 
UIM DC CL8'USRUIM' 


UIMLEN EQU  *-UIM 


* 


Figure 31 (Part 1 of 2). Application Interface Program Example 
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UAPTR 
UA@ 
UALEN 


* 


USERAREA 


COM1 
SECNDCOM 


COM2 
THIRDCOM 


COM3 
FOQURCOM 


COM4 
ENDCOMM DC 
* 


SAVEAREA DS 
* 


END 


2,4 

AL2 (UALEN) 
A 

*-UAG 


AL1(COM1) Length of first command © 


C' WTO '‘'USRAIPGM INVOKING DFDSS''' 
*-USERAREA-1 

AL1(COM2) Length of first command 
C' DUMP DS(INC(**)) LOGINDD(DASD) OUTDD(TAPE) ' 
*-SECNDCOM-1 

AL1(COM3) Length of third command 
C IF LASTCC=O -' 

*~THIRDCOM-1 

AL1(COM4) Length of fourth command 
C' THEN DEFRAG DON(DASD) ' 

*~FOURCOM-1 

X'Q0' End of command flag 


18F 


Figure 31 (Part 2 of 2). Application Interface Program Example 
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HHKK A IKKE ERR KKEK IKK TREKKA RR REER ERR ER RERERREREREREEREREEEKRKRA KR 


* 


* Module Name = USRUIM 


* 


Descriptive Name = DFDSS User Interaction Module en for the 
ark _ Reference Guide. ; 


Function = Perform various functions at different exit 
points. 
Exit Point Operation 


0 Initialize counters for task 

1 Insert SYSIN records from Userarea 
2 Insert table of accounting data 

3 Count Tape Blocks Read 

4 Count Logical Tape Blocks Read 

5 Count Logical Tape Blocks Written 
6 Count Tape Blocks Written 

7 Count DASD Tracks Read 

8 Count DASD Tracks Written 

9 


+ + & F + HF F HF HF HF FF HF HK HF FF HF HF F HE HF F F HF F 





Nothing 
10 (Reserved) 

ll Insert a WTO message 

12 Never allow ADR369D 

13 Force Reblocking 

14 Convert counts to printable characters 
ee 15 Always Bypass password protection for tape = 
es 17 Suppiy TAPEQ1 as a tape volser * 

" 18 Nothing id 

es 19 Save Tape DDNAME and volser which had error * 
ee 20 Save Data Set name * 
| * 21 Do not process temporary data sets * 
ie 22 Bypass serialization of SYS1 data sets - 
BS 23 End function if processing errors a 


KKK KKK KK KK KK KKK KEK KK KKK KEK KK KKK KK KKK KKEKKKKK KKK KK KKK ER 


* 


USRUIM CSECT 

USRUIM AMODE 31 

| USRUIM RMODE ANY 

i KR RR RR KR KR OO KKK KK KE KK KK KKK KKK KKK KE KKK KKK KKK KEK 
: * Registers with special uses ® 
RK KK RR KEKKKKKR KR KK RRR RK K EK KEK RK RK KK KKK KK KK KK KKK KK ek KK 


* 





EIDBASE EQU 2 Base reg for ADREIB. 

| OPTION EQU 3 Reg to test option 
WORKREG EQU 4 Work register 
LENGTH EQU 5 Reg to get length of records 
TEMPBASE EQU 6 Temporary base reg for exits 
RC EQU 7 Register for return code 
SYSPBASE EQU 8 Register for sysprint recs 
MSGOFF EQU 9 Register for offsets to table 





Figure 32 (Part | of 12). User Interaction Module Example 
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t+ + & FF HF +t F HF HF FF FF HF FHF HF HF HK KF FF FE KF HH F 4H KF HF 





UIM 


KAKI K KEKE K KKK ERE KR KKK KKK RRR KKK 


* Save Registers and Establish Addressability. * 


HHA KHAKI EI KI IIR EIR IK ERR EKER EERE REEEEREKRERKK KEKE 


USING *,15 Initial Addressability 
ST™ 14,12,12(13) Save regs 

BALR 12,0 New base addressability 
USING *,12 . 
DROP 15 

B BEGIN 

DC CLI6'CSECT - USRUIM' 


KIKI KK KK KKK KKK EKER KEKE KERRIER ERR KKK KK 


* Establish Addressability to EIDB - 
KHAKI KKK KKK KKK KK KK KKK KKK RRR KKK KKK RKRKRKKKRKKEK 
BEGIN 15,13 Save caller SA pointer 
13, SAVEAREA Set my SA pointer 
15, SAVEAREA+4 Backward Chain 
13, SAVEAREA+8 Forward Chain 
ADREIB, EIDBASE Addressability to EIDB 
EIDBASE,0(,1) Address of EIDB . 
OPTION, EIOPTION Get DFDSS processing option 
OPTION,2 Multiply times four 
15, VECTABLE Point to vector table start 
15,0(OPTION,15) . Point to processor routine 
BALR 14,15 > Go to processor routine 
L 13, SAVEAREA+4 Restore SA pointer 
RETURN (14,12) Return to DFDSS 


KKKKKRKRKEKK KKK KR KKK KK REE KRERIEK KR K RK RKERKRRERR ERK RRERRREEEEER 


* Processing Routines * 
Kk kk ee eek eo ek Rk ee ee oe ee ko ek ee ee ke ke ke ee ee ee KKK { 





ee He ee ee ee ee ie ewe oe te 20 2 ee eee ee eo ee ok eek ee ae Ke RK 


* AIOPTQO: Function Startup * 
* Initialize counters for tape and dasd accounting. x 
* Insert message identifying task into table * 


Tee ee ee eee ete ee KR KE KKK KKK KK KKK KR KK KEKE KKK RK RK RK Re eK 


AIOPTOO XC RTBCNT ,RIBCNT Initialize Tape Blocks Read 
XC WIBCNT ,WIBCNT Initialize Tape Blocks Written 
XC RLTBCNT,RLTBCNT Init Logical Tape Blocks Read 
XC WLTBCNT ,WLTBCNT Init Logical Tape Blocks Written 
Ae RDTCNT ,ROTCNT Initialize Disk Tracks Read 
XC WDTCNT ,WOTCNT Initialize Disk Tracks Written 
ICM WORKREG,15,EITSKID Get current task identifier 
CVD WORKREG,CVDWORK Convert to decimal 
UNPK OPTOOTSK(2),CVDWORK+6(2) Unpack into message insert 





OI OPTOOTSK+1,X' FQ’ 
L MSGOFF ,MSGCOUNT 
MH MSGOFF ,MSGLEN 


Make last character printable 
Get current MSGCOUNT 

Muitiply py MSGLEN to get 
offset into message table 





| 

: LA WORKREG,MSGTABLE 
LA TEMPBASE,0(MSGOFF, WCRKREG) 
USING TABLEMAP, TEMPBASE 
MVC  TABENTRY(133),OPTOOMSG Move into msgtable 
DROP TEMPBASE 
L WORKREG ,MSGCOUNT 
LA WORKREG, 1 (WORKREG) 
ST WORKREG,MSGCOUNT Save new count 
LH RC, EITRCOO Set normal process retcode 


Increment MSGCOUNT 





Figure 32 (Part 2 of 12). User Interaction Module Example 
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STH 


BR 





RC, EIRETCOD 
14 


Store retcode in EIDB 
Return to intercept processor 


RHEHKKKEKKKCKRE ERE KKK REEKREEKRERE KEE EKEEKREKEREEREEREKREKRKERERERKEEKE 


* AIOPTOL: 


Read SYSIN Record 


* 


* Get SYSIN records from the UserArea and give them to DFDSS * 


* using the Insert Record return code. . ~ 
PIS SSS CCLSLOCCCLCLCTCCTSOCTICLCTOCCCCCCLCCCCC CCCI LCST LLL SET TLL L ST fT tt 


AIOPTO1 TM 
BO 


NXTSYS OL 


SYSDEL 


| SYSRCOO LH 
| SYSEXIT STH 
BR 


AIOPTO2 ICM 
USING 
CLC 
BNE 
T™ 


BO 








SYSINFL,SYSIFRST 
NXTSYS 
SYSINFESYSIFRS1 


TEMPBASE,15,EIUSEPTR 


TEMPBASE, CURCOMM 
TEMPBASE , CURCOMM 
WORKREG, 1(, TEMPBASE) 
WORKREG,15,EIRECPTR 
LENGTH, LENGTH 
LENGTH,0(, TEMPBASE) 
LENGTH, LENGTH 
SYSDEL . 
LENGTH, 15,ETRECLEN 


TEMPBASE,1(LENGTH, TEMPBASE) 


TEMPBASE ,CURCOMM 
RC, EITRCO8 

SYSEXIT 

LENGTH, 15,EIRECLEN 
LENGTH, LENGTH 
SYSRCOO 

RC, ETRC12 

SYSERET 


SYSPBASE,15,EIRECPTR 
SYSPMAP ,SYSPBASE 
MSGID(8) ,ADRO12I 
NOTLAST 
SYSPRFL,INSDONE 
NOTLAST 

WORKREG, INSERTCT 
MSGOFF ,WORKREG 
WORKREG , 1 (WORKREG) 
WORKRES ,MSGCOUNT 
INSERT 

SYSPRFL, INSDONE 
WORKREG, TRAILER 
WORKREG,15,EIRECPTR 
WORKREG ,MSGLEN 
WORKREG,15,EIRECLEN 
RC, ETRCO8 

SYSPEXIT 


Q. First entry to SYSIN exit? 
A. No, get next input 
Indicate first time taken 
Get address of UA 

Save pointer to first record 
Get current command pointer 
Get past length 

Initialize the pointer 

Clear workreg 

Get length of record 

Q. End of SYSIN data? 

A. Yes, bypass SYSIN DS 

Set record length 

Point to new record 
Save new pointer 

Set insert. record_retcode 
Continue setup 

Get current record length 

Q. EOF condition ? (reclen=0) 
A. Yes, process it. 

Set delete record retcode 
Continue Setup 


Store retcode in EIDB 
Return to intercept processor 


RRR KK RK KKK RK KK KKK RR KKK KR KKK REE KKK KKK KEKE KK KKK KEKEEK 
* AIOPTO2: Write SYSPRINT 
* Insert SYSPRINT records before message ADRO12I * 


kk RK RRR KR KR RR RR KKK KK ER KKKKK KKK KK KR KKK KK KKK KK KKK KKK 


* 


Q. Last SYSPRINT rcd? 

A. No, don't insert records 
Q. Are we done inserting? 

A. Yes, don't insert records 


Save INSERTCT for offset 
Increment INSERTCT and 

Q. Have we printed all rcds? 
A. No, insert another record 
Indicate we are done inserting 
Point to trailer record 

Store into EIRECPTR 

Update EIRECLEN 


Set insert record retcode 


Figure 32 (Part 3 of 12). User Interaction Module Example 
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age 





INSERT MH MSGOFF ,MSGLEN Multiply by MSGLEN to get 
LA WORKREG ,MSGTABLE offset into message table 
LA WORKREG, 6 (MSGOFF , WORKREG) 
STCM WORKREG,15,EIRECPTR Store address in ELRECPTR 
LH WORKREG,MSGLEN 
STCM WORKREG,15,EIRECLEN Store length in EIRECLEN 





L WORKREG, INSERTCT Increment MSGCOUNT 
LA WORKREG, 1 (WORKREG) 
St WORKREG, INSERTCT Save new count 
LH RC, EIRCO8 Set insert record retcode 
B SYSPEXIT 
NOTLAST LH RC, EIRCOO Set normal process retcode 
SYSPEXIT STH RC,EIRETCOD Store retcode in EIDB 
BR 14 Return to intercept processor 
kkk kh hhh keke KKK RRR KKK RRR KRACK KKK RRR 
* AIOPTO3: Read Tape Block Exit 7 
* Count Tape Block records read n 
Heke KERR KK RRR EKER RAKE AREER HERE REREKKEKKRRERKKRKKRRRKERE 
AI0OPTO3 LH WORKREG,RIBCNT Increment Read Tape Block 
LA WORKREG, 1 (WORKREG) count 
STH WORKREG,RTBCNT 
LH RC, EIRCOO Set normal process retcode 
STH RC,ELRETCOD Store retcode in EIDB 
BR 14 ; _ Return to intercept processor 
KARR RR KKK RK KKK KKK ERK KER RE RKRKERKRRERKEREERKRRERKREERERRRKK KKK 
* AIOPTO4: Read Logical Tape Block Exit | - 
* Count Logical Tape Block records read ss 
RRKKKKKKE KK KKK KK KEK RK KKK aR RRR K 
| AITOPTO4 LH WORKREIG,RLTBCNT Increment Read logical Tape 
| LA WORKR. 23,1 (WORKREG) Block count 
STH WORKREG,RLTBCNT 
LH RC, EIRCOG Set normal process retcode 
Sipe Re EPReCOp Store ratcode in EIDB 
BR 14 Return to intercept processor 
tek ok ek kek oe a ok ox wo ci kk I kk ke kek eke ok tek ke de ek ke ok eee aK ke 
| * AIOPTO5: Write Logical Tape Block Exit ‘ 
| * Count Logical fase Block records written m 
i oko ek kk ie ok ox ok kk ke ok ke kok kok ke kk kk ee ok ke ek ek ee 
| AIOPTOS LH  WORKREG,WLTBCNT Increment Write logical Tape 
LA  WORKREG,1(WORKREG) Block count 
| STH WORKREG,WLTBCNT 
LH RC, ELRCOO Set normal process retcode 
STH RC, ELRETCOD Store retcode in EI0B 
BR 14 Return to intercept processor 
ek OR RR i eek on ox ox OR oe ek ok RR kkk do dk ok kok ok do eke eke ee te 
/ * ALOPTQ6: Write Tape Block Exit 2 
' * Count Tape Biock records written me 
! tok Oo Ok ok ok kk eae ok Oo oO ko io ek kok ko doko ok ok kok ke ek 
_ ATOPTO6 «LH — WORKRES,WTBCNT Increment Write Logical 
LA WORKREG, 1 (WORKREG) Tape Block count 
STH WORKREG,WTBCNT 
LH C,E1RCO0 Set normal process retcode 
STH RC,ELRETCOD Store retcode in EIOB 
BR 14 Return to intercept processor 








Figure 32 (Part 4 of 12). User Interaction Module Example 
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UIM 


f 
i 
i 
i 
i 
i 
1 
\ 
i 
1 
| 
t 
| 








KAKI KEKE KKK IKK KEK KEK REE ERE KK KEE RE EREREEKEKERERREREEEREKEK 


* AIOPTQ7: Read DASD Track Exit i 
* Count DASD Tracks read ia 
He KI KK KI KKK KK KK RK KKK IKK KKK KKK KK KKK KEKE KK KK KKEKKKEKKEKEKEKKKEKE 
AIOPTO7 LH WORKREG, RDTCNT Increment Read DASD Track 
LA WORKREG, 1 (WORKREG) count 
STH WORKREG,RDTCNT . 
LH RC,EIRCOO Set normal process retcode 
STH RC,EIRETCOD Store retcode in EIDB 
BR 14 Return to intercept processor 
KKK KK KK KEE KERR RK KEKE EK RE ERE REE KE RRERERERKEKEERKEERERREERKERKRER 
* AIOPTO8: Write DASD Track Exit * 
* Count DASD Tracks written = 
KERIKERI KEK EERE K KK RRR REECE RRR REAR EREREKRREREKKEREKERREEEE 
AIOPTO8 LH WORKREG,WDTCNT Increment Write DASD Track 
LA WORKREG, 1(WORKREG) count 
STH WORKREG,WDTCNT 
LH RC,EIRCOO Set normal process retcode 
STH RC,EIRETCOD Store retcode in EIDB 
BR 14 Return to intercept processor - 
KKK IKK RK KKK KKK RRR RRR RK KK RR RKK ERK KKK RRRKEKEKRERRREKREKERRRKEEREREE 
* ATOPTO9: Read Utility SYSPRINT * 
am ERERKKEKRK KK ERR KR KEKE KE KKK ER KEKE KEKE KK KERR REE KEK KEK RERERR ERK KEK K 
AIOPTO9 LH  RC,EIRCOO Set normal process retcode 
STH  RC,EITRETCOD Store retcode in EIDB 
BR 14 Return to intercept processor 
KEK KK KKK RRR K RR KERR RE KKK EK RK RRR KEK RK RK KKK RR KK RRR KKK RRR KR KEKE KKEKER 
* ATOPT10: Reserved * 
KR KKK KR RKO OOK KR Oe EK KR ER TKK RK KE 
ATOPT1iO LH RC,ETRCOC Set normai process retcode 
STH RC,ETRETCOD Store retcode in EIDB 
BR 14 Return to intercept processor 
KKK RR Kw RK RK KKK RE OD KR KR RRR KEKE 
* AIOPT11: Write WTO Message S 
* Delete the WTO and insert my own = 
KK KK Ke I IK KK KKK RK KKK KKK KR RE KEK RRR KKK KE KEK KKKEEK 
i AIOPT11 LH WORKREG ,WTOCT Check WIO count 
LTR WORKREG,WORKREG Q. Is WIOCT 0? 
BZ OPTILINS A. Yes, insert one 
OPT1IDEL LH RC, EIRC12 . Set delete record retcode 
B OPTLIXIT (delete all other WTOs) 
OPTILINS LA WORKREG , 1 (WGRKREG) Increment WTOCT 
STH  WORKREG,WTOCT 
LA WORKREG,UIMWTC Get adcaress of WTO 
STCM WORKREG,I5,EIRECPTR Store it in EIRECPTR 
LA WORKREG ,WIOLEN Get length of WTO 
STCM WORKREG,15,EIRECLEN Store length it in EIRECLEN 
LH RC,EIRCO8 Set insert record retcode 
B OPT11XIT 
OPT11IXIT STH RC,EIRETCOD Store retcode in EIDB 
BR 14 Return to intercept processor 





Figure 32 (Part 5 of 12). User Interaction Module Example 
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KRARKKKK KKK KKK KEIR KKK KEKE RK EERE KKKRKK KKK KKK 


* AIOPT12: Write WTOR Message 


| * Check for ADR369D, never allow it to write over VTOC, etc * 


* 


KKKKK KKK KKK KK KKK KKK KK RRR KKK REE RK KKK RKKEKE 


| ATOPT12 ICM 
| CLC 


OPT12XIT STH 


| 

| 

| OPT12RCO LH 
BR 


WORKREG,15,EIRECPTR 


12(8,WORKREG) , ADR369D 


OPT12RCO 
WORKREG,UIMRESP 
WORKREG,15,EIRECPTR 
WORKREG,RESPLEN 
WORKREG,15,EITRECLEN 
RC, EIRC28 

OPT12XIT 

RC, EIRCOO 

RC, EIRETCOD 

14 


Q. Authorize request? 

A. No, let DFDSS issue WTOR 
Get address of response 
Store in EIRECPTR 

Get length of response 
Store in EIRECLEN 

Set WTOR Response retcode 


Set normal process retcode 
Store retcode in EIDB 
Return to intercept processor 


BRK KKK KKK KKK KK KKK RK KKK KARE KK KKK KKK EK KK KK EK REKREKRREKKREEKRKEKEEKREREEK 


* AIOPT13: Present ADRUFO Record 


* If parm call, set IO and AI buffers above 16M * 
* If function call and Copy, force reblocking. ; " 
KRRRKKKK KK KK RKK KIRK RK KKK RRERERRKRERKKRRKAKKRERKRRRRKKKRKRKKRR KK RARRK 
; AIOPT13 ICM  TEMPBASE,15,EIRECPTR 
| USING ADRUFOB, TEMPBASE Establish addressability to UFO 
po ’ CLC  UFFUNCT,PARM ~ Q. Is this a PARM call? 
BE PARMCALL A. Yes, go to parm call 
FUNCTION TM UFFUNCT1,UFFUCOPY Is this a COPY? 
BNO OPT13RCO No, don't change options 
| SR WORKREG,WORKREG 
ICM WORKREG,3,UFBDYOQFF Get offset for PARM list 
AR WCRKREG,TEMPBASE Add to address of UFO 
USING UFOFUNCT ,WORKREG Establish addressabdility 
Of UFOINSOP ,UFOFRBLK rorce reblocking 
LY RC, EIRCI6 Set modify record retcode 
5 OPT13XIT 
PARMCALL SR WORKREG,WORKREG This is a parm call. 
ICM WORKREG,3,UFBDYOFF Get offset for PARM list 
AR WORKREG, TEMPBASE Add to address of UFO 
; USING UFOFUNCT ,WORKREG Establish addressability 
| OI UFXAFLAG, UFXABUFF Make sure IO buffers are >16M 
Ol UFXAFLAG,UFAI31B Make sure AI buffers are >16M 
LH RC, EIRC16 Set modify record retcode 
LA WORKREG,2 Initialize message table: 
St WORKREG ,MSGCOUNT Initialize msgcount 
LA TEMPBASE,MSGTABLE Get address of tabdie 
USING TABLEMAP, TEMPBASE 
MVC TABENTRY(133) ,HEADER Move header into msgtabie 
LA TEMPBASE,133(TEMPBASE) Move past first message 
MVC  TABENTRY(133),BLANKS Move blank line into table 
| B OPT13XIT Exit. 
| OPT13RC0 LH RC, EIRCOO Set normal process retcode 
| OPTI3XIT DROP TEMPBASE 
! STH RC,EIRETCOD Store retcode in EIDB 
| BR 14 Return to intercept processor 


* 


: 


Figure 32 (Part 6 of !2). 
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RRAKEKEKREKKEREEKEEREEREEEEERKEEREREREREEREEREEREERKEREREREREREKRKEKRKKKRKGKKK 





* ATOPT14: Function Ending 


KKK KK KKK KK KKK KHER EKER EKER RE KEKE KEKE EKER EEE EERE EREREREEREKEKKRKE 


* 


AIOPT14 LH WORKREG, RTBCNT Get Tape Blocks Read 

CYD WORKREG,CVDWORK Convert to decimal 
UNPK RTBINS,CVDWORK Unpack into message insert 
OI RTBINS+7 ,X'FO' Make last character printable 
LH WORKREG ,WTBCNT Get Tape Blocks Written 
CVD WORKREG,CVDWORK Convert to decimal 
UNPK WTBINS,CVDWORK Unpack into message insert 
OI WIBINS+7,X'FO' Make last character printable 
LH WORKREG, RLTBCNT Get Tape Logical Blocks Read 
CVD WORKREG,CVDWORK Convert to decimal 
UNPK RLTBINS,CVDWORK Unpack into message insert 
OI RLTBINS+7 ,X'FQ' Make last character printable 
LH WORKREG,WLTBCNT Get Tape Logical Blocks Written 
CVD WORKREG,CVDWORK Convert to decimal 
UNPK WLTBINS,CVDWORK Unpack into message insert 
OI WLTBINS+7,X'FQ' Make last character printable 

. LH WORKREG, RDTCNT Get Disk Tracks Read 
CVD WORKREG,CVDWORK Convert to decimal 
UNPK RDTINS,CVDWORK Unpack into message insert 
OI RDTINS+7 ,X'FQ' Make last character printable 

; LH WORKREG,WDTCNT Get Disk Tracks Written 
CVD WORKREG,CVDWORK Convert to decimal 
UNPK WDTINS,CVDWORK Unpack into message insert 
OI WOTINS+7 ,X'FO' Make last character printable 
L MSGOFF ,MSGCOUNT Get current MSGCOUNT 
MH MSGOFF ,MSGLEN Multiply by MSGLEN to get 

| LA WORKREG ,MSGTABLE offset into message table 

LA TEMPBASE,O(MSGOFF,WORKREG) 


USING TABLEMAP, TEMPBASE 
MVC TABENTRY(133),READMSG Move into msgtable 

LA TEMPBASE,133(TEMPBASE) Increment pointer for 2nd msg 
MVC TABENTRY(133),WRITEMSG Move into msgtable 

DROP TEMPBASE 

L WORKREG , MSGCOUNT 
LA WORKREG, 2(WORKREG) 
Si WORKREG, MSGCOUNT 
LH RC, EIRCOO 

STH  RC,EIRETCOD 


Increment MSGCOUNT 


Save new count 
Set normal process retcode 
Store retcode in EIDB 





BR 14 Return to intercept processor 
FRR KKK KKK KKK RK KK KKK KKK KKK KKK KK KEK KKK KKK KKK EK KE KEK KKK KKKKRER 
* ATOPT15: Present WTOR Response = 
RRR KK KKK KE RK KKK KKK KKK KKK KEKKKK KEK KK KKK KK KEK KKK RK RK RK RK KK KK KKK RK 
AIOPT15 LH RC,EIRCOO Set normal process retcode 

STH RC ,EITRETCOD Store retcode in EIDB 

BR 14 Return to intercept processor 


Figure 32 (Part 7 of 12). User Interaction Module Example 
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eee er a SR en a a ra a a a OT ne ee oe En | 





KKK KK KKK Ke he KKK IK IR KEKE IRAE RIKER KERR 


* AIOPT16: OPEN/EOF Tape Security and Verification 7 


* Always bypass password protection * 
KkKKKKK KKK KKK KKK KR KK a RK aa EEE RRR KKK KKK KKK aR KKK 


AIOPT16 ICM TEMPBASE,15,EIRECPTR Get address of record 


LH RC,EIRC16 Bypass password protection 

ST RC ,Q(TEMPBASE) Store in EIRECPTR 

LH RC,EIRC16 Set modify record retcode 

STH  RC,EIRETCOD Store retcode in EIDB 

BR 14 Return to intercept processor 
RRIKKEK KKH KEKE KEKE EEE REE EEK KKKKKKKEEKKKKKREKRKEE 
* AIOPT17: OPEN/EOF Non-specific Tape Mount = 
* Supply DFDSS with TAPEOQL . 


RKKRIKKREKKK Fe KK KK IKKE KIKI RIKKI RKIREREREEREREKREEREREREREREREREKE 


AIOPT17 ICM  TEMPBASE,15,EIRECPTR Get address of record 
MVC 0(6,TEMPBASE) , TAPEO1 Supply TAPEO1 as specific volser 


LH RC,EIRC16 Set modify record retcode 

STH RC,EIRETCOD Store retcode in EIDB 

BR 14 Return to intercept processor 
Sete de ete te te See dete te te te de he Se Se he Se he te he he he de he he Se he he he be Fe KI IIA IAI KKK IKE KIARA 
* AIOPT18: Insert logical VSAM Record during Logical Restore * 
KEKE KK RK KKK KK ERK RR KIRKE KEKE ERK RK RE KEKE KRKREKRKKERERKRKKKKRKRKKKRK ERK 
AI0PT18 LH RC,EIRCOO Set normal process retcode 

STH RC,EIRETCOD : Store retcode in EIDB 7 

BR 14 Return to intercept processor 
HRA KK KKK HK eK RKEKKKEKEERERKEK REECE ERERREEREERKEREEREEKEEREKREREERRRREER 
* AIOPT19: Output Tape 1/0 Error * 
* Save DDNAME, Volser, and Return code, print record. * 


KOR KR EK RE RRR K KKK KKK KKK KKK KEK KKK KKK RRR KKK KEKE KKK 


AIOPT19 [cM EMPBASE,15,ELRECPIR Get address of EIRECORD 


USING EIDDINFO,TEMPBASE Est addressability to DDINFO 
MYC = OPT1900, EIDDNAME Move DDNAME to message 

MVC = OPTISYS ,ETVOLID Move VOLSER to message 

SR WORKREG, WORKREG Clear out work register 

le WORKREG, EIRETC Get return code 

CVD WORKREG,CVDWORK Convert to decimal 

UNPK OQPT19RC(2) ,CVDWORK+6(2) Unpack into message insert 
Of OPTISRC+1,X'FQ' Make last character printable 
DROP TEMPBASE 

L MSGOFF ,MSGCOUNT Get current MSGCOUNT 

MH MSGOFF ,MSGLEN Multiply by MSGLEN to get 

LA WORKREG ,MSGTABLE offset into message table 


LA TEMPBASE,O(MSGOFF,WORKREG) ; 
USING TABLEMAP, TEMPBASE 

MYC  TABENTRY(133),O0PT19MSG Move into msgtable 
DROP TEMPBASE 


L WORKREG ,MSGCOUNT Increment MSGCOUNT 

LA WORKREG, 1 (WORKREG) 

ST WORKREG,MSGCOUNT Save new count 

LH RC,EIRCOO Set normal process retcode 
STH  RC,EIRETCOD Store retcode in EIDB 

BR 14 Return to intercept processor 
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| 


| 
| 


RUKH IKK KKK KERIKERI KRRREKRERRERREKEEKKEERERKEREKRKKEEE 


* AIOPT20: Volume Information Exit = 
* Save Data Set name n 
kKkkKKRKKKK KKK KKK RK KK KER TKK RR KKK RRR EKER RERRRRERKERKERAEKKREKR 
AIOPT20 ICM  TEMPBASE,15,EIRECPTR Establish addressability to 

USING EIREC20, TEMPBASE EIREC20 

MVC OPT2QDSN(44) ,EIZ6DSN Move data set name into message - 

DROP TEMPBASE 

L MSGOFF ,MSGCOUNT Get current MSGCOUNT 

MH MSGOFF ,MSGLEN Multiply by MSGLEN to get 

LA WORKREG, MSGTABLE offset into message table 

LA TEMPBASE ,0 (MSGOFF ,WORKREG) 

USING TABLEMAP, TEMPBASE 

MVC  TABENTRY(133),OPT2QMSG Move into msgtable 

DROP TEMPBASE 


L WORKREG ,MSGCOUNT Increment MSGCOUNT 

LA WORKREG, 1(WORKREG) 

ST WORKREG ,MSGCOUNT Save new count 

LH RC, EIRCOO Set normal process retcode 
STH RC,EFRETCOD 3 - Store retcode in EIDB 

BR 14 Return to intercept processor 


KRKKKIKK KKK KKK KERR ERK KR RK KEK RERKRREKRE REE RRERERKEERREKRRKEKRREKKKER 


* AIOPT21: Data Set Verification Exit 
Do Not Process TEMP Data Sets 


KBKKEKKKKKERKREKKEEKEKRKKKKERREREERERERREKRKEREREREKERRRKERERKREERRREREREREE 


AIOPT21 CLC €121DSN(4),TMPL 


BNE LABEL1 Then 
LH RC, EIRC36 Do not process data set 
B LABEL2 Else 


LABEL? LH RC, ETRCOO Set normal return code 
LABEL2 STH RC,EIRETCOO Store retcode in EIDB 
BR 14 Return to intercept processor 


Te kk kK oe eee KKK KK KEK KKK KE KKK KKK KKK EK KEK KKK KK EEK 


| * AIOPT22: Bypass Verification Exit 


- Bypass Serialization of SYS1 Data Sets 


KKK KKK KKK KKK KKK KK IKK KK IKK KR KKK KK KKK KKK ER ERK RR KK KEKREKRKREKEEKKKER 


AIOPT22 CLC EI21DSN(4),SYSL If first 4 chars of dsname='SYS1' 


BNE LAB1 Then 

LH RC,EIRC16 Bypass serialization of data set 
NI EI22FLGS,B'O1111111' Set EI22BSER bit on 

B LAB2 Else 


LAB1 LH RC, EIRCOO Set normal return code 
LAB2 STH RC,EIRETCOD Store retcode in EIDB 
BR 14 Return to intercept processor 
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If first 4 chars of dsname='TEMP' 





a a ee RE ee 


Hy 
2 ee ne A RR 








KHER KKKK KKK KEKE EEE REE REE KR KE ERR ERKKKRKRREK 


* AIOPT23: Data Set Processed Notification Exit 

= End Function If Errors in Processing 

kkk khkkkekkkkikhkh kkk keke aK KKK REE RR 

AIOPT23 LH WORKREG, EI23D0SRC If data set processing RC not zero 
LTR WORKREG,WORKREG Then 


BZ 

LH 

B 
LABLI LH 


LABL2 STH 


BR 
* 
CURCOMM DC 
SYSINFL DC 


SYSIFRST EQU 


SYSPRFL DC 


INSDONE EQU 


TMPL DC 
SYSL DC 
* 


LABL1 

RC, EIRC36 
LABL2 
RC,EIRCOO 
RC, EIRETCOD 
14 


Fig! 
X'Q0' 
X'80' 
X'00' 
X'80' 
C'TEMP' 
C'SsyS1' 


End function 

Else 

Set normal return code 

Store retcode in EIDB 

Return to intercept processor 


Address of current command 


SYSIN Flag 

First entry SYSIN Performed 
SYSPRINT Flag 

Done inserting SYSPRINT recs 
TEMP high-level qualifier 
SYS1 high-level qualifier 








SAVEAREA DC 18F'Q' My save area 
* 
' VECTABLE DC A(AIOPTOQ) — Function Startup Exit 
VECO1 DC A(AIOPTO1) Read SYSIN Exit 
VECO2 DC A(AIOPTO2) Write SYSPRINT Exit 
VECO3 Dc A(AIOPTO3) Read Tape Block Exit 
VECO4 DC A(AIOPTO4) Read Logical Tape Exit 
VECO5 DC ACATOPTOS) Write Logical Tape Exit 
| VECQ6 BC A(AIOPTC6) Write Tape Block Exit 
| VECO7 DC A(AIOPTO7) Read DASD Track Exiz 
VECO8 DC A(AIOPTO8) Write DASD Track Exit 
VECO9 DC A(ATOPTO9) Read Utility Sysprint Exit 
; VECIO DC AATIOPT10) Reserved 
VEC1L1 DC A(AIOPTi1) Write WIO Message Exit 
VECI2. DC  A(AIOPT12) Write WTOR Message Exit | 
VEC13 DC ACAIOP7i3) Present ADRUFO Record Exit 
VEC14 DC A(AIOPT14) Function Ending Exit ! 
VEC15 DC A(AIOPT15) Present WTOR Response 
VEC16 DC A(AIOPT16) OPEN/EOF Tape Sec/Ver Exit 
VECI? DC A(AIOPT17) OPEN/EOF Non-Spec Tape Mount 
VEC18 DC A(AIOPT18) Insert logical VSAM Rcd -Restore | 
| VECL9 DC A(AIOPT19) Output Tape 1/0 Error Exit 
| VEC20 oc A(AIOPT20) Volume Information Exit | 
VEC21 OC A(ALOPT21) Data Set Verification Exit | 
| VEC22 DC ACAIOPT22) Bypass Verification Exit 
VEC?S DC A(AIOPT23) Data Set Processed Notification Exit 
* | 
| ee ec a ca SN Pr I I EL ee a | 
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UIMWTO 
WTOLEN 
* 


UIMRESP 
RESPLEN 
* 


ADR369D 
ADRO121 
* 


MSGLEN 
INSERTCT 
MSGCOUNT 
* 


RTBCNT 
WTBCNT 


* 


RLTBCNT 
WLTBCNT 
* 


RDTCNT 
WOTCNT 
* 


WTOCT 
<3 


PARM 


* 


TAPEO1 
* 


* 


| HEADER 


* 


_ TRAILER 


og 


| BLANKS 

* 

READMSG 
RDTINS 





| RTBINS 


| RLTBINS 


| 
| o* 
| 
| 
| 


DC 
DC 


DC 
DC 


DC 


DC 


DC 


DC 
DC 


DC 
DC 


C'>>> USRUIM is active <<<' 
*-UIMWTO Show that we are active 


CT Reply T to ADR369 
*-UIMRESP 


CL8'ADR369D' DFDSS Authorization WTOR 
CL8'ADRO12I' Last DFDSS message id 


H'133' Length of messages 
F'Q' Count of messages given to DFDSS 
F"O Count of messages in table 


Count of Tape Blocks Read 
Count of Tape Blocks Written 


H'Q' Count Logical Tape Blocks Read 
H'Q' Count Logical Tape Blocks Writn 
H'@' te Count Disk Tracks Read - 

H'Q' Count Disk Tracks Written 

H'Q' Count of WT0s 

X'0Q000' Parm call test for Opt 13 
CL6'TAPEQ1' Tape volser for Opt 17 


GC KKK KAKO KK KKK KKK Begin USRUIM Messages 
CEs 3 (HEADER) fi ERE e REE RR SER EARERE ESS ERE ER ERA EE ERA 


KRKRKKKERERKERKKERKREKREKKREKKEKREKER KERR KERK! 


C! KKK KEK KEKE RKEKKKEEER End USRUIM Messages i 
CLULSS=C*aTRALLER) ) SAS Pee ee RR AER RE ES ERE EAA AS REA ERE RES 


KERKKREKREKKKKEREKRKEKEKREKRERERERKKEREEKE | 


CEI33¢ Blank message 


C" Disk Tracks Read: : 
C'XXXXXXXX! 

C? Tape Blocks Read: 
C'XXXXXXXX! 

G Logical Tape Blocks Read: 
C'XXXXXXXX! 
CL(133-(*-READMSG))' ' 
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WRITEMSG 
WOTINS 


WTBINS 


WLTBINS 


* 


OPTOOMSG 
OPTOOTSK 


*® 


OPT1LOMSG 
OPT190D 


QPT19VS 


OPTI9RC 


* 


OPTZOMSG 
OPT2O0DSN 


* 


CVDWORK 
* 


* 


USRUIM 
MSGTASLE 
* 
TABLEMAP 
TABENTRY 
* 


SYSPMAP 





dC 


DS 


ADREID 


ADRUFO 


CSECT. 
DS 


DSECT 
DS 


DSECT 
DS 
DS 


END 


Say Disk Tracks Written: ' 
C'XXXXXXXX! 
C' Tape Blocks Written: ' 


C'XXXXXXXX! 

C' Logical Tape Blocks Written: ' 
C' XXXXXXXX' 

CL(133-(*-WRITEMSG))' ' 


C' Messages follow for task: ' 
C'XX' 
CL(133-(*-OPTOOMSG))' ' 


Ct Permanent Tape Error for DDNAME: ' 
C'XXXXXXXX! 

C* VOLSER: ' 

C'XXXXXX ! 

C' Return Code: ' 

C'XX! 

CL(133-(*-OPT19MSG))' ' 


C' EI2QDSN = ''' 

C'XXXXXXXX .XXXXXXAXK « AXAXXAAX « AXXXAXAX « AXXXXAXX | 
«! tui 

CL(133-(*-OPT20MSG))* * 


D Workarea for decimal conversions 
0 Macro to map EIDB 

Macro to map UFO 
CL13300 Room in table for 100 msgs 

DSECT to insert msgs into table 
CL133 

DSECT to find MSGID in DFDSS 
CL1 messages 
CL7 
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re 2 an 





1PAGE 0001 DFDSS 5665-327 


~ADRO101 PRIME(01), 
WTO 'USRAIPGM INVOKING 
ADR1011 RIQ1 (01), 
DUMP DS(INC(**)) LOGIN 
ADR1011 RIO1 (91), 
IF LASTCC=0 - 
ADR1011 RIQ1 (01), 


DATA FACILITY DATA SET SERVICES V2R5.0 88.008 16:28 
SIZE VALUE OF 4096K WILL BE USED FOR GETMAIN 

DFDSS' 

TASKID 001 HAS BEEN ASSIGNED TO COMMAND ‘WTO ' 
DD(DASD) OUTDD (TAPE) 

TASKTD 902 HAS BEEN ASSIGNED TO COMMAND 'DUMP ' 


TASKiD 003 HAS BEEN ASSIGNED TO COMMAND ‘IF ' 


THEN DEFRAG DDN(DASD) 


ADR1611 RI61 (61), 
ADR1091 RIQ1 (01), 
QADROO6I (002) -SETUP(O1), 
OADR3171 (002)-OPNC_ (01), 


OADR4541 (002) -DTOSC(31) 


MODODOOOOODODODOOO 


QADRO13I (002)-CLTSK(01), 
@ADROOGI (004)-SETUP(O1), 
QADR3171 (004) -OPNC_(O1). 


GADR3171. (664)-OPNCL(81}, 


QADR2Q81 (004) -DANAL(O1), 
1PAGE @002 DFDSS 5665-327 





9 
0 
0 
| 0 
9 
QADR2201 (904}-D2N2. 21), 
ND ENDS AT CC:4e 2298:9000 


GADR2091 (004) -oF54G (51), 
eet (004) -DANAL/91), 





OVDooooeon 


IPAGE 0003 DFDSS 5565-327 
~ADR2121 (004)-DANAL{91), 


TASKID 664 HAS BEEN ASSIGNED TO COMMAND ‘DEFRAG ° 

88008 16:28:31 INITIAL SCAN OF USER CONTROL STATEMENTS COMPLETED. 

88606 16:28:31 PROCESSING BEGINS 

THE DEVICE SIZE FIELD IN THE YTOC IS INCORRECT IF VOLUME SYSTEM IS NOT A MINIVOLUME. DEVICE SIZE OF 0100 
CYLINDERS WILL BE USED 


» THE FSLLOWING DATA SETS WERE SUCCESSFULLY PROCESSED 


SYS2.LINKLIB | 
SYS1.CMDLIB 

SYS2.TELCMLIB 

SYS1.VTAMLIB 

SYS1.HELP 

SYS2.LINKLIB 

SYS2.DGTCLIB 

SYS? .DGTSLIB 

SYS2.OGTPLIB 

SYS1.DGTMLIB 

SYS1.DGTTLIB 

SYSi.DGTLLIB 

USERA. LINKLIB . 
USERC.LINKLIB , 
88068 16:30:04 TASK COMPLETED WITH RETURN CODE 0000 
88008 16:30:06 PROCESSING BEGINS 
THE DEVICE SIZE FIELD IN THE VTOC IS INCORRECT IF VOLUME SYSTEM IS NCT A MINIVOLUME. DEVICE SIZE OF 0100 
CYLINDERS WILL BE USED 
THE DEVICE SIZE FIELD IN THE VTOC IS INCORRECT IF VOLUME SYSTEM IS NOT A MINIVOLUME. DEVICE SIZE OF 9108 
CYLINDERS WILL BE USED 

BEGINNING STATISTICS ON SYSTEM: 

DATA FACILITY DATA SET SERVICES V2R5.0 88.008 16:28 


FREE CYLINDERS 0009 
FREE TRACKS 9013 
FREE EXTENTS 0003 
LARGEST FREE EXTENT (CYL,TRK) 0005,0000 
FRAIMENTATION INDEX 258 
PECTIN: PREG. SPACS a9 
INTEx,++. BEGINS AY Co: 9091:90000 A 


MOVED EATENT GOL FROM 9096:0000-0097:9014 TO 9084:9000-0085:0014 FOR USERC.LINKLL3 
END: STATISTICS ON SYSTEM: 


DAT: S27 EXTENTS RELOCATED 9001 
TRALDKS RELOCATED 0030 
FREZ TYLINDERS 9009 
FREE "RACKS 9013 
FREE EXTENTS 9002 | 
LAR3ES7 FREE EXTENT (2YL,7RK) 9009,0000 
FRSSVEMT ATION INCEX 074 


i 
nae + FACILITY DATA SET SERVICES V2R5.0 88.008 16:28 | 
EXTEN” DISTRIBUTION MAP FOR SYSTEM: | 
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TNL SN35— 0375 (01 Sept 1990) to SC26-4389-1 feat - oe eee Bf f,°, | 





0 EXTENT **INPUT FREE** **QUTPUT FREE** ** QCCUPIED ** 
SIZE 
IN NO. CUM. NO. CUM. NO. CUM. 
TRACKS EXTS PCT/100 EXTS PCT/100 EXTS PCT/100 
1 0.000 0.000 3 0.002 
2 0.000 0.000 7 9.012 
5 4.900 2.000 2. 9,949 
1d 3.900 0.000 2 9.934 
12 0.000 0.000 1 6.043 
13 0.000 1 0.087 0.043 
14 0.000 “9.087 1 0.053 
20 9.000 0.087 2 9.083 
30 1 9.202 0.087 2 9.127 
36 3.202 0.087 2 9.154 
43 1 9.493 9.087 1 9.186 
75 i 1.000 0.087 1 @.24i 
100 1.000 0.087 2 0.389 
135 1.000 1 1.000 Q.389 
>499 1.900 1.000 1 1.900 


ADRO13I (004)-CLTSK(G1}, 28008 16:30:20 TASK COMPLETED WITH RETURN CODE 9¢00 


RRKRKKEREKERERKKRERKRKRKEER Begin USRUIM Messages WKH HII KK KIKI RK KEKE VIR S RUKIA IKKE IKKE KRE KKK RE KAKI KRR 


Messages follow for cask: 02 
Disk Tracks Read: 90001159 Tape Blocks Read: 00090000 Logical Tape Btocks Read: ofoloforororere) 
Disk Tracks Written: 00000000 Tape Biccks Written: 00001990 Logical Tape diocks Written: 00001158 
Messages follow for task: 04 
Disk Tracks Read: 00000030 Tape Blocks Read: 00000000 Logical Tape Blocks Read: 00000000 
Disk Tracks Written: 90000060 Tape Blocks Written: 90000000 Logical Tape Blocks Written: 00000000 
RUAKKEKKEKKKKKKEEKKKKKRKKK End USRUIM Messages HHH IK KK IK IKK IKK ERIK IK ERK KKK KK KK KKK EK KKK IKK KKK KK ISIE EK REE REKRK CHK KK IK 
OADROIZI =—«—-dDSSU (G1), 88008 16:30:20 DFDSS PROCESSING COMPLETE. HIGHEST RETURN CODE IS 0000 = 
1 















| 
ae 





. x ~ 


Figure 33 (Part 2 of 2;. Output Resulting trom Use or the UIM Exits 
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-AUKITAPB Data Area i “Bhan oe “> “TNL SN35—- 0375 (01 Sept 1990) to SC26-4389-1 °° 





Appendix E. Data Area Descriptions 


This appendix contains two data area descriptions corresponding to control blocks 
ADRBMB and ADRTAPB. 


_ For a description of ADRUFO, see Figure 14 on page 155. 
For a description of ADREID0, see Figure 27 on page 197. 


Product implementation information is contained in this chapter. 


ADRBMEB Data Area 
ee ee Product Implementation Information ennai 


Figure 34. ADRBMB Mapping Macro 








Offsets Name Description 
0 (0) CHARACTER * ADRBMB 
oO - _ (0) CHARACTER - 12 BMHDR  ..._—s_..._—... ‘BITMAP HEADER... | - 
0 (0) CHARACTER 4 BMID BLK IDENTIFIER EBCDIC “BMBB’ 
4 (4) ADDRESS 4 BMNPTR ADDR OF NEXT BITMAP | 
SEGMENT/0 
8 (8) FIXED 2 BMNTRK NUMBER OF TRACKS MAPPED BY | 
SEGMENT 
10 (A) CHARACTER 2 bg RESERVED | 
12 (C) BITSTRING 0 BMBITMAP BITMAP LAYOUT. CONTIGUOUS 
| BITS FOR EACH TRACK. | = 
OPERATE ON CORRESPONDING 
TRACK. 0 = SKIP TRACK 
| 
Name Hex Offset Struct Level 
ADRBMB 0 (0) 
BMBITMAP {2 iC 
BMHDR 0 Oh 
BMID 0 (01 
BMNPTR 4 (4) 
BMNTRK 8 (8) 
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ADRTAPB Data Area 




























i Offsets Type Length Name Yeseription 
| 0 (0) CHARACTER 16 ADRTAPB 
0 (0) CHARACTER 6 DTPSCHK 
0 (0) FIXED 4 DTPSEQNO SEGMENT SEQUENCE NUMBER 
4 (4) FIXED 1 DTPNOSEG NUM OF SEGMENTS PER RECORD 
5 (§) FIXED I DTPSEGNO SEGMENT NUM OF RECORD 
| 6 (6) FIXED 2 DTPSEGLN SEGMENT LENGTH INCL PREFIX 
3 (3) FIXED i DTPPFXLN LENGTH OF PREFIX(CONSTANT 16) 
| 9 (9) CHARACTER l DTPDMPID TYPE OF DUMP ID 
beac DTPFULD $80 FULL DUMP 
L.. DTPPARTD 40 PARTIAL DUMP 
volt. DTPDASDD 20 DATASET DUMP 
i val DTPLOGCL 10 LOGICAL DUMP THIS BIT IS 
CALLED DTPCATDD IN V2 RI. BIT IN 
| STRUCTURE TO MAINTAIN COM- 
PATIBILITY BETWEEN V2 RI, V2 R2 
AND V2 R3 
Lill * RESERVED DO NOT USE LAST 4 BITS 
IN DTPDMPID TO ENSURE DOWN- 
\ WARD COMPATIBILITY 
| 10 (A) BITSTRING i DTPRCID!i RECORD IDENTIFIER | 
Lissa fe DTPVHDR 80 VOLUME HEADER 
Pg egy DTPTHDR TAPE HEADER 
wl. F DTIPBIM 40 MAP OF DUMPED TRKS 
sh. DTPDSNL DS NAME/CATALOG LST 
wl. DTPTRKO 20 TRACK 0 
als 4 DTPDSHDR DATA SET HEADER 
l elias DTPVTOC 10 VTOC TRACK 
Eke DTPVOLD YOLUME DEFINITION 
sa Eide DTPDATA 08 DATA TRACK 
alas DTPVTRLR - ~ 04 VOLUME TRAILER 
ihe DTPDTRLR DS TRAILER 
als DTPVVDS 02 VVDS TRACK 
perere 1 DTPSPHDR 01 SPHERE REC HEADER 
il (B) BITSTRING I DTPRCFLI FLAG BYTE 
balws DTPDDISP IF ON, DATA EQUAL TO LENGTH 
OF ADRTAPB HAS BEEN DISPLACED 
FROM THIS SEGMENT TO THE LAST 
SEGAIENT OF THE TRACK 
DTPDDOSP IE LAST SEGMENT DISPLACED 
A Sie RECLACED SIRST ; 
SEE DIP DDISP) | 
: oh tel DTPENDCD !=END GF CDF DATA SET 
vet Ettl * RESERVED | 
A 'C) CHARACTER 4 7 RESERVED 
1D > CHARACTER CYPBCDY START GF REMAINDER OF RECORD | 
i DTVOL 
i) (0) CHARACTER 46 DTVOL 
3 -0) CHARACTER 4 DT¥TOCB ¥TOC BEGINNING CCHH 
4 (4) CHARACTER 4 DTVTOCE VTOC ENDING CCHH | 
i 3 4) CHARACTER 4 BDTVOLSZ WOLOUME SIZE DS4DEVSZ) 
: 8 (8) FIXED a DTVYLOGCY 2 OF CYLINDERS IN VOLUME : 
i a) 1A) FIXED 7 DTVTRKCY # OF TRACKS PER CYLINDER | 
lg iC) FIXED 2 DTVBLKSZ MAXIMUM BLOCKSIZE 
| i4 (E) FIXED 2 DTVMAXCB MAXIMUM COMPRESS BUFFER IN 
WORDS j 
16 110) CHARACTER 6 DTVSERL VOLUME SERIAL OF SOURCE YOL 
| a2 (16) CHARACTER 1 DTVVTOCI VTOC INDICATORS | 
j Be 117) CHARACTER 8 DTIVTIMD DATE & TIME OF DAY OF DUMP 
=> -i7) CHARACTER 4 DTVDAY E 2XOYYDDBC | 
a? 1.8) CHARACTER 4 DTVTIME OF DAY IN DECIMAL | 
at 1F} CHARACTER 4 DTIVDEVTY DEY TYP OF VOLUME:CCBTBYTS4 
45 23) FIXED | DTV¥ MODNO MODEL NUMBER 
36 24) BITSTRING I DTVINDI VOLUME TYPE iNDICATORS 
Sus cee DTVVIRT au VIRTUAL VOLUME | 
be DTVMINI 40 MINI DISK 
sae DTIVCVAF 20 VOLUME HAS INDEXED VTOC 
wal’ ss, * 1) NOT USED 
te DTV FCMP 8 FILE COMPRESSED 
wh. DT¥UNLCD O04 UNALLOCATED SPACE DUMPED 
vale DTVLVF 02 OTHER LOGICALVOLUMES MAY | 
FOLLOW THIS LOGICALVOLUME i 
Mes a Sei l DTVVVDS 01 VVDS DATASET DUMPED H 
| BEFORE VTOC 
| a (25) FIXED 2 DTY BMSZ BITMAP SIZE IN WORDS 
| 39 (27) BITSTRING 1 DTVIND2 VOLUME TYPE INDICATORS 
Bese, edies DTVLNVI 80 NONVSAM DATA SETS NOT ON 
VOLUME 
H its DTYLVYI 40 VSAM DATA SETS NOT ON 
VOLUME 
i 
i ks DTVGNVI 20 NONVSAM DATA SETS NOT ON 
ANY VOLUME 





nN 
nN 
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Figure 35 (Page 2 of 3). ADRTAPB Mapping Macro 






























Offsets Length Description 
fa ee DTVGVI 10 VSAM DATA SETS NOT ON ANY 
VOLUME 
me ee DTVSMS SOURCE VOLUME IS SMS 
MANAGED 
ai. DTVSMSI SOURCE VOL [8 3M5 INITIAL STAGE 
UNUSED 
DTVLEN 
DTVLEN 
40 (28) FIXED 2 DTVLEN "LEN OF HEADER = SEGMENT 
LENGTH PREFIX 
42 (2A) FIXED I DTVVERNO DFDSS VERSION NUMBER 
43 (2B) FIXED 1 DTVLVLNO DFDSS MCDIFIC. NUMBER 
44 (2C) FIXED I DTVVXTNO NUMBER OF VVDS EXTENTS 
45 (2D) FIXED 1 DTVVXTOF OFFSET TO VVDS EXTENT 
DTHDR 
0 (0) CHARACTER 18 DTHDR 
0 (0) CHARACTER 8 DTHTIMD DATE & TIME: DAY OF DUMP 
0 (0) CHARACTER 4 DTHDAY DAY 
4 (4) CHARACTER 4 DTHTIME TIME 
8 (8) CHARACTER 1 DTHIND?2 DATA SET TYPE INDICATORS 
bead DTHGNVI NO NON VSAM DATA SETS 
athe SA DTHGVI NO VSAM DATA SETS 
lL LH . RESERVED | 
9 (9) FIXED 2 DTHLEN HEADER LENGTH 
i (B) FIXED 1 DTHVERNO DFDSS VERSION NUMBER 
12 (C) FIXED 1 DTHLVLNO DFDSS MODIFIC. NUMBER 
13 (D) FIXED 2 DTHBLKSZ MAX BLKSIZE 
15 (F) FIXED 2 DTHNDS NO. POTENTIAL DS 
17. *(11) CHARACTER 1 DTHIND1 INDICATORS . 
(eee DTHFCMP FILE COMPRESSED 
Sta one DTHUNLCD UNALLOCATED SPACE DUMPED 
bile Fee, DTHSFER SPHERE OPTION | 
ol ETE 7 RESERVED 
DTLDSN 
0 (0) CHARACTER 45. DTLDSN ; a ae - 
0 (0) FIXED 1 DTLLEN LENGTH OF DATA SET NAME 
! (1) CHARACTER 44 DTLCAT CATALOG NAME 
DTDSHDR | 
0 (0) CHARACTER 106 DTDSHDR 
0 (0) FIXED l DTDLEN LENGTH OF DATA SET NAME 
i (1) FIXED i DTDCATLN LENGTH OF CATALOG NAME 
2 (2) CHARACTER 2 DTDDSORG DATA SET ORGA (FROM F}) 
4 ($) CHARACTER I DTDOPTCD DS OPTION CODE FROM Fy 
5 (8) CHARACTER i DTDNVOL NUMBER Ola FoR DATA SET 
5 ia: BITSTRING : OTBIND 
Was, as DTDIPWD 
| DTDTPWD | 
| 
| te DTDIRACF | 
STOR ACES 
DTDRACFD | 
aoe DIDRACFG = 
| te DTDALIAS = USER: 
Als DTDSPER = SPHERE RECORD FOLLOWS 
| fb, tee DTDSMS Df OATA SET 
i 7 (7) CHARACTER 8 DTDPWD ? 
15 (F) CHARACTER 44 DTDCAT CATALOG NAME 
59 (3B) CHARACTER 4 DTDDSN DATA SET NAME 
103 (67) CHARACTER 2 DTDVOLCT VOLCOUNT (FROM BCS) 
103 (67) FIXED I DTDVCTD VOLCOUNT FOR DATA COMPO- 
NENT GR NONVSAM DATA SET 
| 104 (88) FIXED i DTDVCTI VOLCOUNT FOR INDEX COMPO- 
NENT OR ZERO FOR NO INDEX 
| 105 (6°) CHARACTER I DTDIND2 DATA SET INDICATOR 2 | 
Bestest: DTDAIXSP MIX : 
te. DTDCOF aa BATS OSET i 
Hse DTDPDSE 2 SEE 
{ : i * “i sno 
| DTSPHERE 
0 (0) CHARACTER 4 OTSPHERE 
) (0) FIXED 4 OTSLEN SPHERE RECORD 
| DTSINKO | 
N) (0) CHARACTER 102 DTSINFO SPHERE INFORMATION 
| 0 (0) CHARACTER 44 DTSAIXNM AEMONAME | 
io 4 (2C) CHARACTER 44 DTSPATHN PATH NAME 
88 ($8) CHARACTER 1 DTSPATHA PATH ATTRIBUTE 
89 (39) BITSTRING I DTSPATHF PATH INFO FLAG 
| 
| Fetches DTSPATHI [F SEY. PATH OWNERID [5 CON- 
| TAINED IN THIS BLOCK (SEE 
OTSPTHON FOR DESCRIPTION) 
(Pe DTSPATHE PATH EXPIRATION DATE [S CON- 
TAINED IN THIS BLOCK (SEE 
OYSPTHEP FOR DESCRIPTION). LE 
NOT SET. 1G SQEE THE EXPIRE 
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ADRTAPB Data ‘Area 














101 
DTSPASSW 
0 


0 


8 
16 
24 
32 
40 
42 
50 
DTIMVOL 
0 
0 
6 
10 


19 


12 
16 
18 


4 
a 


22 


24 
23 
26 
DTBIMR 
0 
0 
9) 
4 


8 
10 
DTTTRK 
9 
0 


0 
2 


A ted es 


ro 


24 


DITCKD 
0) 
0 
0 


CePA MBtVvoC Ss 


wee LT 

(SA) CHARACTER 
(62) CHARACTER 
(62) CHARACTER 
(42) FIXED 

(63) FIXED 


(65) FIXED 


(0) CHARACTER 
(0) CHARACTER 


(8) CHARACTER 
(10) CHARACTER 
(18) CHARACTER 
(20) CHARACTER 
(28) FIXED 

(2A) CHARACTER 
(32) FIXED 


(0) CHARACTER 
(0) CHARACTER 
(6) CHARACTER 
(A) CHARACTER 
(CY CHARACTER 
(C) FIXED 


(10) FIXED 
(12) FIXED 
(14) FIXED 
(16) CHARACTER 


tiS) FIXED 
w.9) FIXED 
:.A) FIXED 
i.3) CHARACTER 


(0) CHARACTER 
(0 CHARACTER 
HY CHARACTER 
i4) FIXED 


i8) FIXED 
(A) CHARACTER 


i0) CHARACTER 
(0) CHARACTER 


(0) FIXED 
(2) CHARACTER 


i7) CHARACTER 
(0) CHARACTER 
(18) CHARACTER 


(0) CHARACTER 
0) CHARACTER 
(0) CHARACTER 
(9) CHARACTER 
(0) FIXED 
(2) FIXED 
id) FIXED 
(3) FIXED 
(6) FIXED 
(0) CHARACTER 
(0) CHARACTER 


ponanak NON OO O&O WW 


NNNN 


tyra bh 


o 


ANI rH tdisa MDa 


DTSPATHP 


DTSPRACF 
DTSRACFD 
DTSRACFG 
* 


DTSPTHON 
DTSPTHEP 
DTSEXPIR 
DTSEYEAR 
DTSERDAY 


DTSEXCNY 


DTSPASSW 
DTSMSTRP 


DTSCNTLP 
DTSUPDAT 
DTSREADP 
DTSCODEN 
DTSNUMAT 
DTSAUTNM 
DTSAUTHR 


DTMVOL 
DTMVSERL 
DTMDEVTY 


DTMVOLSZ 
DTMTRKCP 


DTMLOGCY 


DTMTRKCY 
DTMMAXCB 
DTMIND 
DTMVIRT 
DTMMINI 
DTMCVAF 
DTM#ZVVRS 
DTM=DSCB 
DTIMSEXT 
DTSMODNO 


DTBIMR 
TBHDR 
DT 3 BMID 
DTBADDR 


DTBTRK# 


DTTTRK 
DTTHDR 


DTTTRKLN 
DTTTRKID 
DTTIOER 
DTTTROVF 
DTTTCMP 
DITVFRST 
DTTINVT 
DTTSTAT 
DTTCCHH 
DTTCC 
DTTHH 
DTTVSERL 
DTTRODAT 
DTTBODY 


DTTCKD 
DTTCNT 
DTTCCHHR 
DTTCCCHH 
DTTCCC 
DTTCHH 
DTTCRCRD 
DTTKELEN 
DTTDATLN 
DIRTLR 
DTRSERL 


Description 


PATH HAS PASSWORD THAT IS 
CONTAINED IN THIS BLOCK (SEE 
DTSEXPIR FOR DESCRIPTION). IF 
EXISTS, BEGINS AT DTSPATHD. 
PATH RACF FLAGS 
{=DISCRETE PROFILE 

1+ GENERIC PROFILE 
NOT USED 
FORMAT OF OWNERID : 
EXPIRATION DATE FORMAT: 
YYDDDF FORMAT 
YY 8 BIT IN DECIM 

2 BITS DAY OF IN DECIMAL & 4 BIT 
SIGN UNPACKED 
CENTURY BYTE IN DECIMAL 


SECURITY INFO TABLE 

MASTER PASSWORD. MUST HAVE 
IN ORDER TO HAVE ANY OTHER 
PASSWORDS. 

CONTROL INTERVAL PASSWORD 
UPDATE PASSWORD 

READ PASSWORD 

CODE NAME 

NUMBER OF ATTEMPTS 

ADDR OF AUTHORIZATION MOD 
AUTHORIZATION REC LENGTH 


VOLUME SERIAL ID 

DEVTYPE (UCBTBYT4) 

SLACK FILLER 

VOLUME SIZE : DS4DEVSZ) 
#BYTES/TRK (TRACK CAPACITY 
WITH OVERHEAD). . 

# CYLINDERS PER VOLU ME 

# TRACKS PER VOLUME 

MAX COMPRESS BUF IN WORDS 
VOLUME INDICAT 

VIRTUAL VOLUME 

MINI VOLUME 

VOLUME HAS INDEXED VTOC 

2 OF VVRS NYRS DUMPED 

= OF DSCBS OUMPED 

OF EXTENTS DEMSED 
MODEL NUNISER 


RESERVED 

ID OF THE BLOCK = 3.5BB 
OF NEXT 3!33 SEGMENT 
FROM ADR23'3 BLOCK 

= OF TRKS MAPPED iN 8MBB SEG 
RESERVED 


COPIED 


MAPS THE TRACK 
HEADER FOR EACH TRACK 
SEGMENT 
LENGTH OF DATA ON TREK 
TRACK INDICATORS 
I1.O ERROR ON TRACK 
LAST REC ON TRK IS OVFLO REC 
IF ON. TRACK COMPRESSED 
FIRST VVDS RECORD 
INVALID TRACK FORMAT 
USER STATISTICAL RECORD 
CCHH OF TRACK 
CYLINDER NUMBER 
TRACK NUS{3ER 

VOLUME SERIAL 
RCRD 0 DATA. ONLY ON i ST SEG 
Ri RN RECORDS ON TRACK 


CNT, KEY & DATA FIELDS ON TRK 
COUNT FIELD 

CCHHR OF RECORD 

CCHH OF RECORD 

CC OF RECORD 

HH OF RECORD 

R OF RECORD 

KEY LENGTH 

DATA LENGTH 


VOLUME SERIAL OF FILE 
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ADRTAPB Data Area 


Name 


ADRTAPB 
BFRPREFX 
BPBODY 
BPHWMRK 
BPSCOC 
BPSCOD 
BPWORKA 
DTBADDR 
DTBBMID 
DTBHDR 
DTBITMR 
DTBTRK# 
DTDAIXSP 
DTDALIAS 
DTDCAT 
DTDCATLN 
DTDCDF 
DTDDSN 
DTDDSORG 
DTDIND 
DTDIND2 
DTDIPWD 
DTDIRACF 
DTDLEN 
DTDNVOL 
DTDOPTCD 
DTDPDSE 
DTDPWD 
DTDRACFD 
DTDRACFG 
DTDRACFP 
DTDSHDR 
DTDSMS 
DTDSPER 
DTDTPWD 
DTDVCTD 
DTDVCTI 
DTDVOLCT 
DTHBLKSZ 
DTHDAY 
DTHDR 
DTHFCMP 
DTHGNVI 
DTHGV!I 
DTHIND1 
DTHIND2 
DTHLEN 
DTHLVLNO 
DTHNDS 
DTHSFER 
DTHTIMD 
DTHTIME 
DTHUNLCD 
DTHVERNO 
DTLCAT 
DTLDSN 
DTLLEN 
DIM#DSCB 
DTM#EXT 
DTM#VVRS 
DITMCVAF 
DTMDEVTY 
DTMIND 
DTMLOGCY 
DTMMAXCB 
DTMMINI 
DTMMODNO 
DTMTRKCP 
DTMTRKCY 
DTMVIRT 
DTMVOL 
DTMVOLSZ 
DTMVSERL 
DTPBODY 
DTPBTM 
DTPDASDD 
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Hex Offset 


67 


OK 


= MOQ © 0 


- Oo 


— — me fa a ed — ee 
CKSSNSANNDWALOANAwWDYOSCO-wW 


Struct Level 
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Name 


DTPDATA 


DTPDDDSP 
DTPDDISP 
DTPDMPID 
DTPDSHDR 
DTPDSNL 
DTPDTRLR 
DTPENDCD 
DTPFULD 
DTPLOGCL 
DTPNOSEG 
DTPPARTD 
DTPPFXLN 
DTPRCFL| 
DTPRCID1 
DTPSCHK 
DTPSEGLN 
DTPSEGNO 
DTPSEQNO 
DTPSPHDR 
DTPTHDR 
DTPTRKO 
DTPVHDR 
DTPVOLD 
DTPVTOC 
DTPVTRLR 
DTPVVDS 
DTRSERL 
DTRTLR 
DTSAIXNM 
DTSAUTHR 
DTSAUTNM 
DTSCNTLP 
DTSCODEN 
DTSERDAY 
DTSEXCNY 
DTSEXPIR 
DTSEYEAR 
DTSINFO 
COTSLEN 
DTSMSTRP 
TSNUMAT 
OTSPASSW 
DTSPATHA 
DTSPATHE 
DTSPATHE 
DTSPATHI 
DTSPATHN 
DTSPATHP 
DIUSPHERE 
DTSPRACF 
DTSPTHEP 
DTSPTHON 
DTSRACFD 
DTSRACFG 
DTSREADP 
DTSUPDAT 
DTTBODY 
DTTECC 
DTFCECE 
DTTCCCHH 
DTTCCHH 
DTTCCHHR 
DTTCHH 
DTTCKD 
DTTCNT 
DTTCRCRD 
DTTDATLN 
DTTHDR 
DTTHH 
DTTINVT 
DTTIOER 
DTTKELEN 
DTTRODAT 
DTTSTAT 
DTTTCMP 
DTTTRK 
DTTTRKID 
DTTTRKLN 


Hex Offset 


\ oP SC OCSCSRE DOSE PEOCUTOD DH OCHOODWL Y >POWWD 


29 


tw CS we 


oT 


SN DvyvVvyGguwuvnwvwwn sant 


ty 4? 


Struct Level 


tater bd tole e PWwWW AN WN to HK Nw WwW RWW WW WIN lw WWW WH Ww bk db & to Ww Ww 


Wwe 2 ff WwW ff WW blo mw UH le to fH P14 iV lO RR & W fo ed eS Od bo te Lo 
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Name 


DTTTROVF 
DTTVERST 
DTTVSERL 
DTVBLKSZ 
DTVBMSZ 
DTVCVAF 
DTVDAY 
DTVDEVTY 
DTVFCMP 
DTVGNVI 
DTVGVI 
DTVINDI 
DTVIND2 
DTVLEN 
DTVLNVI 
DTVLOGCY 
DTIVLVF 
DTVLVI 
DTVLVLNO 
DTVMAXCB 
DIVMINI 
DITVMODNO 
DTVOL 
DTVOLSZ 
DTVSERL 
DTVSMS 
DTVSMSI 
DTVTIMD 
DTVTIME 
DTVTOCB 
DTVTOCE 
DIVTRKCY 
DTVUNLCD 
DTVVERNO 
DTVVIRT 
DTVVTOCI 
DTVVVDS 
DTVVXTNO 
DTVVXTOF 


Hex Offset 


Struct Level 


ly NW NWN Ww Wb hd) Ww NW WW te tM WH Ww Wid tw ly WWW we NNWD PP 
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_ Appendix F. Macro Library as Part of Programming Interfaces 
_ for Customers 


The macros identified in this appendix are provided to allow a customer instailation 
to write programs that use the services of DFDSS. Only those macros identified in 
this appendix should be used to request or receive the services of DFDSS. 


DFDSS provides a library that contains the macros that are intended to help you 
write programs that use the services of DFDSS. The name of the library is: 
SYS1.SAMPLIB . 


DFDSS provides four product-sensitive programming interfaces and one general-use 
programming interface intended for use by customers. 


Listed below are the product-sensitive and general-use programming interface 
macros in SYS1.SAMPLIB: 


| Product-Sensitive Programming Interfaces : 


Figure 36. Product-Sensitive Programming Interfaces 


4 TNR ee 
ate 


Installation Authorization Exit Routine ADRUPB 


Installation Enqueue Exit Routine ADRUNQB 


Installation Options Exit Routine ADRUFO 


installation Reblock Exit Routine | ADRRBLKB | 
Ae ee ee) ig a Nee ee es es 


End of Preduct-Sensitive Programming Interfaces 


General-Use Programming Interfaces 


Figure 37. General-Use Programming Interfaces | 


| 
i 
| 
| 






Macro 


ADREIDO 
ADRMCLVL 


Interface Name 
Application Interface 





End of General-Use Programming Interfaces 
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Glossary of Terms and Abbreviations 


This glossary includes definitions of some terms found 
in this document. Some of the terms defined below are 
from: 


¢ The American National Dictionary for Information 
Processing Svstems, copyright 1982 by the Com- 
puter and Business Equipment Manufacturers Asso- 
ciation. Copies may be purchased from the 
American National Standards Institute at 1430 
Broadway, New York, New York 10018. These 
definitions are identified by an asterisk (*). 


¢ The JSO Vocabulary - Information Processing, and 
the ISO Vocabulary - Office Machines, developed by 
the International Standards Organization, Technical 
Committee 97, Subcommittee 1. Definitions from 
published sections of this vocabulary are identified 
by the symbol “(ISO)” preceding the definition. 
Definitions from draft proposals and working 
papers under development by the [SO/TC97 vocab- 
ulary subcommittee are identified by the symbol 
“(TC97),” indicating that final agreement has not 
yet been reached among its participating members. 


A 


ABEND. Abnormal end of task. End of a task, a job, 
or a suosvstem because of an error condition that 
cannot be resolved bv recovery facilities while the task is 
performed. 


ABENDxxx. The keyword that identifies the abnormal 
end of DFDSS because of a system-detected error. 


ABSTR. A subparameter of the SPACE parameter in a 
DD statement. It indicates that specified tracks be 
assigned to a data set. 


ACCEPT processing. An SMP/E process necessary for 
installing the FMIDs. SMP/E ACCEPT processing uses 
JCL to accept the modules and macros necessary to run 
the FMIDs. The FMIDs are accepted into the DLIBs 
from the temporary data sets. 


Access method services. A multifunction service 
program that is used to manage both VSAM and 
non-VSAM data sets and integrated catalog facility or 
VSAM catalogs. It is used to define data sets and allo- 
cate space for them, convert indexed-sequential data sets 
to key-sequenced data sets, modify data set attributes in 
the catalog. reorganize data sets, facilitate data porta- 
bility between operating systems, create backup copies 
of data sets, data set records and catalog entries. help 
make inaccessible data sets accessible, list the records of 


data sets and catalogs, define and build alternate 
indexes, and convert OS CVOLs and VSAM catalogs to 
integrated catalog facility catalogs. 


ACDS. Active control data set. 
ACS. Automatic class selection. 
AIX. Alternate index. 


alias. An alternate name for a member of a partitioned 
data set. 


ALLOC. A space allocation parameter that indicates 
type, such as cylinders or tracks. 


alternate index (AIX). In systems with VSAM, a key- 
sequenced data set containing index entries organized by 
the alternate keys of its associated base data records. It 
provides an alternate means of locating records in the 
data component of a cluster on which the alternate 
index is based. 


alternate index cluster. In VSAM, the data and index 
components of an alternate index. 


APAR. Authorized Program Analysis Report. 


Authorized Program Analysis Report (APAR). A 
request for correction of a problem caused by a sus- 
pected defect in a current unaltered release of a 
program. 


APF. Authorized program facility. 


Application Interface. An interface used to invoke 
DFDSS from another program. 


Apply processing. In SMP and SMP7/E. the process, ini- 
tiated by the APPLY command, that places system 
modifications (SYSMODS) into the target svstem 
libraries. 


attach. In programming. to create a task that can be 
performed asynchronously with the performance of the 
mainline code. 


authorization. (1) (TC97) The right granted to a user to 
communicate with or make use of a computer system. 
(2) The process of giving a user either complete or 
restricted access to an object. resource, or function. 


automatic class selection (ACS). A mechanism for 
assigning SMS classes and storage groups. 


© Copyright IBM Corp. 1984, 1989. All Rights Reserved. 
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index 


A 


abend dumps, data set passwords 172 
ABEND = nnn in the EXEC statement 7 
ABOVEI6 in the EXEC statement 7 
access authority 

RACF-protected data sets and DASDVOL 175 
access authority, compatibility with Version 1 162 
Access Method Services 177 
addressing mode 143 
ADRBMB mapping macro 

Output example 220 
ADRDSSU_ 179 
ADREID0 data area 

example 200 
ADRMCLVL macro 201 
ADRRBLKB mapping macro 

explanation 158 

output example 159 
ADRREBLK routine 158 
ADRTAPB mapping macro 

output example 221 
ADRUENQ routine 149 
ADRUFO mapping macro 154 

output example 155 
ADRUIM module 182 
ADRUIKXIT routine 154 
ADRUNQB maroing macro 140 

COLSUP ex asaie, LS] 
ADRUPB mapping macro 145 

output exampie 148 
ADRUPSWD routne 144 
AIX (alternate index), recataloging 
ALLDATA keyword 

COPY command 33 

DUMP command 68 

PRINT command 85 
ALLEXCP keyword 

COPY command 33 

DUMP command 69 
ALLMuitt keyword 

CONVERTY command 25 

COPY command 34 

DUMP command 69 
ALLOC subkevword, DUMP command I4 
allocation of space 47, 116 
ALLX keyword 

COPY command 33 

DUMP command 69 
alternate index. recataloging 35 
AMODE#=31_ 143, 181 
AMSGCNT=nnnn in the EXEC statement 7 
application interface 

blocks 183 


Loy) 
na 
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application interface (continued) 
example 204—205 
structure 181 
application interface summary 196 
application program process 203 
asterisks, rules regarding, in a data set qualifier 10 
authorization checking !44 
data set 173 
general description 171 
volume 173 
authorization exit routine 
return codes 147 
user 144 
auxiliary commands 128 
continuation errors 133 
PARALLEL 128 
SERIAL 128 
SET 129 


backing up (dumping) data 64 
backup copies, multiple 57, 74 
BDAM data sets, copying 45 
BEGIN keyword in VDRL statement davidaicne 
DFDSS) 138 
BELOWI16 in the EXEC statement 7 
BLK subkeywore of TGTALLOC 
COPY commend 47 
RESTORE command 116 
BLKSIZE and LRECL keywords, specifying in a 
PRINT operation 8&7 
butfers above 16 megabytes virtual storage 7 
BY keyword 
COMPRESS command 20 
COPY command 34 
criteria 9 
DEFRAG command 59 
DUMP command 69 
filtering criteria 14 
RELEASE command 93 
RESTORE command 104 
BYPASSACS keyword 
COPY command 34 
RESTORE command 105 


Cc 


calling block structure 179 

CANCELERROR keyword 
COPY command 34 
DUMP command 69 
RESTORE command 105 


CATALOG keyword 
CONVERTV command 25 
COPY command 35 
RESTORE command 105 
catalog search order. standard 16 
CATLG subkevword, DUMP command [4 
changes in DFDSS, this release xu 
characteristics of data sets 9 
class selection, process diagram 120 
codes, condition 
See condition codes 
command syntax, how to read 3 
commands, auxiliary 128 
commands, function 
Sev also function commands 
example 196 
PARM. information in the EXEC statement used to 
control DFDSS 6 
command, null i353 
compaction 70 
compatibility 
among releases of DFDSS_ 163 
between Version | and Version 2 of DFEDSS 162 
of stand-alone with system DFDSS 135 
COMPRESS command 19 
COMPRESS keyword. DUMP command 70 
compressing data sets 19 
condition codes 
general description 129 
LASTCC 130 
MAXCC 130 





COPY command 24, 44 
converting to SMS. JIC 
partitioned ox ta set 3 
partitioned data se 

consere Es POSE. MOE 


RN NS ce mor . forging 23 


example $4 


Rbabee 








non-VSANM daca set. results of COPY on 56 
COPY oceration 

Udie andver selection Mdinik. 176 
CUOPNISL MP cosimendg. 5 


copying stuad-alone DFEDSS restore to tape 139 


236 DEDSS Rerterence 
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COPYVOLID keyword 
COPY command 35 
RESTORE command 106 
CPYV keyword 
COPY command 35 
RESTORE command 106 
CREDT subkeyword, DUMP command {4 
criteria for filtering 9 
CYL subkeyword of TGTALLOC 
COPY command 47 
RESTORE command 116 


D 


DASD space fragmentation 59 
DASDVOL, access authority requirements 175 
data integrity 
DYNALLOC 167 
ENQ. 166 
example of RESERVE-ENQUEUE processing 171 
RESERVE 165 
WAIT option 169 
data mover selection matrix 176 
data set 
authorization checking 173 
BY filtering 14-15 
characteristics (BY criteria) 9 
DUMP 
compatibility with Version 1 162 
examples of 80 
filtering 9 


filtering ertteria 
AGES a 


1< 
cree Nt let tes 





sf fnlie and nnetlialiv a 
Names . examples Of TU ane DarhiaHy quail ied 19 


non-V SAM enqueue options 167 
non-VSAM, results of COPY on 56 
qualifier, rules regarding asterisks in 
RESTORE 
compatibility with Version | 162 
example of 122 
SA\i5-managed data sets 
non-VSAM_ 118 
physical RESTORE actions 118 
VSAM 118 
data-set-changed flag, DUMP command 75 
DATALENGTH keyword, PRINT command 86 
DATASET COPY 
data mover selection matrix 176 
DATASET T keyword 
COPY command 36 
data mover selection matrix for COPY 176 
DUMP command 77 
PRINT command 86 
RESTORE command 106 
DCB keywords LRECL and BLKSIZE, specifying in a 
PRINT operation 87 
DDNAME keyword 
COMPRESS command 26) 
CONVERTY command 25 


in 
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DDNAME keyword (continued) 
DEFRAG command 60 
RELEASE command 93 
DDNAME hist 179 
DDPTR_ 179 
deadlocks during DFDSS runs’ 165 
DEFRAG command 
explanation 59 
output example 63 
results of a successful run 63 
degassing data sets 19 
DELETE keyword 
COPY command 36 
DUMP command 70 
DELETE. compatibility with Version | 162 
detailed notes on using DFDSS 
data set passwords, abend dumps_ 172 
enqueuing versus dynamic allocation 168 
installation authorization exit 172 
lockouts during DFDSS runs 165 
security processing, example of 177 
device names, generic 139 
DFDSS 
application interface 
Structure 18] 
compatibility among releases 163 
data set authorization checking 173 
determining version, release, modification level 
using the ADRMCLVL macro 201 
DFDSS module, main entry point 179 
DFDSS target class selection 121 
exit identification bleck 183 


WSEAS. “SSeS 

how autnerization is checked for vou 171 
input oO 

installation exit routines 143 

JCL 6 

JOE +eguirements.. S 

jobending 134 

lockouts Juring runs 165 

output oO 


PARM information in the EXEC statement 6 
stand-alone restore 135 
target class selection 120 
using PARM{ information in the EXEC statement 
Version 2. compatibiity with Version | 162 
DFDSS. stand-alone restore 135 
DFHSM ~S 
DO-END group of commands 13 
condition for processing 130 
syntax i3l 
DS keyword 
COPY command 36 
DUMP command 77 
PRINT command 8&6 
RESTORE command 106 
DSCHA subxeyword. DUMP command 14 


4 


6 


DSORG subkeyword, DUMP command 14 


DS1DSCHA (data-set-changed flag) 75 
DUMP command 64 

compatibility with Version | 162 

data-set-changed flag 75 

example of a full 79 

example of a tracks 79 

example of data set 80 

multiple copies 74 

syntax 64 
dump data, multiple copies 57. 74 
dump tapes from DFDSS Version | 162 
DYNALLOC keyword 

COMPRESS command 21 

COPY command 37 

DEFRAG command 60 

DUMP command 71 

PRINT command 86 

RELEASE command 94 

RESTORE command 106 
DYNAM keyword 

COMPRESS command. 21 

DEFRAG command 60 

RELEASE command 94 
dynamic allocation of data sets versus enqueuinz 48 


E 


ELSE command 131 

END command. in DO-END 132 

END keyword in VDRL statement (stand-alone 
DFDSS) 138 

END statement in stand-alone DFDSS 138 

ending vour DFDSS joo +134 


ENQ_ 166 
ENQFAILURE subkevword 
COPY command 48 


DUMP command 76 

PRINT command 88 

RESTORE command [17 
enqueue exit routine 

enqueue scheme 149 

options for non-VSAM data sets 167 

user 149 
enqueue scheme 166 
enqueuing versus dynamic allocation of data sets 748 
EOJ command = {34 
ERRORTRACKS keyword. PRINT command x 
examples of 

controlling task processing 130. 132 
examples of common continuation errors 133 
examples of DFDSS jobs 

compressing selected data sets 23 

CONVERTY command 27 

COPYDUMP 58 

data set COPY 51 ; 

data set COPY for device conversion 5] 

data set DUMP 80 


Index 237 


examples of DFDSS jobs (continued) 
data set RESTORE 122 
DEFRAG 62 
examples of 62 
full COPY 50 
fal DUMP 79 
Tun RESTORE 112i 
PRINT 90 
RELEASE 96 
stand-alone DFDSS Restore 141 
tracks COPY 50 
tracks DUMP 79 
tracks RESTORE 121 
examples of qualified data set names 10 
example. syntax 4 
EXCLUDE criteria 9 
EXCLUDE keyword 
COMPRESS command 21 
COPY command 37 
DEFRAG command 60 
DUMP command 71 
RELEASE command 94 
RESTORE command 107 
EXEC statement ([CL) 5—8 
ececanie stand-ajon2e DFDSS Restore -239 
exit identification block 183 
exit interface. structure 183 
exit routines, installation 
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Preface 
This book, Data Facility Data Set Services: Messages, lists messages issued by 
DFDSS, with explanations and action So The audience for this reference 
metes © “"""S = 9g"tisers-who encounter. DFDSS. messages!" °°. 2 SINS 


Data Facility Storage Management Subsystem (DFSMS) is hereafter referred to as 
Storage Management Subsystem (SMS). 


Major Divisions of This Book 
This book contains the following sections: 


« Chapter 1, “How to Read DFDSS and Stand-Alone DFDSS Restore Messages” 
provides general information on and examples of DFDSS messages. This 
. _ chapter explains the differences between DFDSS messages and the and: alone 
| * & DEDSS restore program (ADRDMPRS) messages. — 


| * Chapter 2, “System DFDSS Messages” lists the messages issued by System 
| . DFDSS. 


- Chapter 3, “Stand-Alone DF DSS Restore Messages” fists the messages issued 
by ADRDMPRS. 


¢ Chapter 4, “Problem Determination Table” provides a table that explains the 
codes referred to in the problem determination section of each message. 


Conventions Used in This Book 
The following conventions are used in the text of the actual message: 


* Braces ({ }) indicate a required field or parameter. Only one of the items within 
the braces will appear in the actual message text. 


¢ Brackets ({ ]) indicate an optional field or parameter. The field or parameter 
within the bracket may or may not appear in the actual message text. 


¢ Items separated by a vertical bar (|) represent alternative items. Only one of the 
items separated by a vertical bar may appear in the actual message text. 


¢ Items in quotation marks (‘ ’) indicate the actual key entry the operator must 
make in response to the message. 


The following conventions are used in the explanations of the messages: 


| ¢ Variables, which are shown in italics, symbolically represent either numeric or 
| alphanumeric information that is displayed in the message text. 


¢ Parameters and optional fields referred to in the descriptions of the messages do 
not necessarily reflect the exact characters that must be entered in a command. 
See the appropriate publication for the exact characters that must be entered for 
each command. 


Information for each message includes, where applicable: 
¢ Explanation: The meaning of the message, the causes, and the variable fields. 


« System Action: Actions resulting from the conditions causing the message or 
reason code. For example, the system may be waiting for a response. 
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Programmer ‘Response: The pertinent ‘Tesponse, ifa Tesponse is ‘necessary, ‘and ” 


the effect of that response on the system or program. The programmer can be 


_the application programmer or the system programmer, depending on 1 the 


problem to be corrected. 


Operator Response: The pertinent response, if a oe 1S necessary, and the 
“effect of that response ‘on"the; system" or. programs! 





Problem Determination: If a problem occurs again or is persistent to the point 
that system efficiency suffers, the actions that can be performed to obtain 
adequate data for trained hardware or programming-support personnel to 
diagnose the problem. 


Problem determination items refer to Chapter 4, “Problem Determination 


Table” on page 73. This table does not teach diagnostic techniques but informs’ 


the operator or programmer of actions to take when problems occur again. The 
problem determination instructions are aids to identifying hardware or 
programming problems and to ensuring that essential programming information 
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Data Facility Data Set Services: General Information, GC26-4123, introduces 
you to DFDSS and helps in anes its use. It is Pay oueciee to data 


processing management. 


Data Facility Data Set Services: User's Guide, SC26-4388, gives guidance on 
how to use DFDSS. 


Data Facility Data Set Services: Reference, SC26-4389, describes DFDSS 
command syntax. 


Data Facility Data Set Services: Diagnosis Guide, LY27-9538, tells how to 
diagnose errors you might encounter while using DFDSS. 


Data Facility Data Set Services/Interactive Storage Management Facility: 
Instailation Planning Guide, SC26-4129, tells what to consider when you plan 
for and install DFDSS/ISMF. 


Within the text, references are made to some of the publications listed below. 
Others are publications that may be useful. 


MVS/370 Publications: 


Short Title Long Title Order Number 

JCL User's Guide MVS/370 JCL User's Guide GC28-1349 

JCL Reference MVS/370 JCL Reference GC28-1350 

Linkage Editor and Loader MVS/370 Linkage Editor and GC26-4061 
Loader User's Guide 

System Generation MVS/370 Installation: System GC26-4063 


Generation 
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Short Title | 
JCL Reference 





JCL User's Guide oh. PSRs 


Linkage Editor and Loader 


System Generation 


MVS/ESA Publications: 


Short Title 


Application Development Macro 
Reference 


Catalog Administration Guide 


CVAF Diagnosis Reference 


Data Management Macro 
Instructions 


DFP: General Information 


JCL Reference 
JCL User's Guide 


Storage Administration Reference 
System-Data Administration 


VSAM Administration: Macro 
Instruction Reference 


« MVS/Extended ‘Architecture 


Long Title 


MVS/Extended Architecture 
JCL Reference 


JCL User's Guide 


MVS/Extended Architecture 
Linkage Editor and Loader 
User's Guide 


M VS/Extended Architecture 
Installation: System Generation 


Long Title 


| MVSJESA Application 


Development Guide 
MVS/ESA Application 


_ Development Macro Reference - 


MVS/ESA Catalog 
Administration Guide. 


MVS/ESA Common VTOC 
Access Facility Diagnosis 
Reference 


MVS/ESA Data Management 
Macro Instructions 


MVS/ESA Data Facility 
Product Version 3: General 
Information 


MVS/JESA JCL Reference 
MVS/ESA JCL User's Guide 


MVS/ESA Storage 
Administration Reference 
MVS/ESA System-Data 
Administration 
MVS/ESA VSAM 
Administration: Macro 
instruction Reference 


MVS/DFP Version 3.3 Publications: 


Short Title 


Access Method Services Reference 


MVS/DFP: General Information 


Long Title 


MVS/DFP Version 3 Release 3: 


Access Method Services for the 
Integrated Catalog Facility 


MVS/DFP Version 3 Release 3: 


General Information 
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Short Title | ‘Long Title” Order Number 
MVS/DFP: Storage MVS/DFP Version 3 Release 3: _SC26-4566 
Administration Reference . Storage Administration 
Reference 
ee MVS Message Library ‘Publications: 330 Nese: Wes ang 
Short Title Long Title Order Number 
Dump Output Messages MVS/ESA Message Library: GC28-1814 
. Dump Output Messages 
Routing and Descriptor Codes MVS/ESA Message Library: GC28-1816 
A Routing and Descriptor Codes a 
System Codes MVS/ESA Message Library: GC28-1815 
System Codes 
System Messages Volume | MVS/ESA Message Library: GC28-1812 
Sat heen System Messages Volume ! 
"” System Messages Volume 2°” ~~ ~MVS/ESA Message Library: °  GC28-1813 
System Messages Volume 2 
Device Support Facility Publications: — | 
Short Title Long Title Order Number 
Device Support Facility User's ICKDSF User's Guide and GC35-0033 
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System Programming Library Publications: 
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Application Development Guide MVS/ESA System GC28-1852 
Programming Library: 
Application Development Guide 
Application MVS/ESA System GC28-1854 
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Addressability Application 
Development—Extended 
Addressability 
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VM/SP CP General User Virtual Machine/System SC19-6211 


Command Reference Product CP General User 
Command Reference 





Teer a aae ah ty pene amonarecrreg +=. pr erxktnpnctorrna ten 
ee Ks 





Srey ae ies x oe BRP eam ES as, WR Ae: east ee 
peerorate atiy pea ee ie ae owe rue a 
REGS ase Au Tee ees eis BSC Tse Scere SERS San Re ae ee 








RES n Races, cee hea Pana me qine = 
ye . Soe oe feos are 








Contents 
Chapter 1. How to Read DFDSS and Stand-Alone DFDSS Restore Messages . | 
How This Book Explains Messages ...........0 0000 ee eee ues 1 
~ i Gta FS he Format of System DFDSS:Messages 22.07 DUTY ee aD te 
The Format of Stand-Alone DFDSS Retox ies erie, Sot he perth Bee tig 
Chapter 2. System DFDSS Messages ...... deh Pea ot Ee He at. ea 5 
Chapter 3. Stand-Alone DFDSS Restore Messages ............. id BOT 
Chapter 4. Problem Determination DANES ches tek do aces deine Bok Wea te 73 
Table I. Standard Problem Determination Actions ................ 73 
| Appendix A. Use of Interrupt Key ......................000. 75 
| Stand-alone: Restore Environmi¢nt’ «405 0x 40h a4 Bt a ee AS a Ae 75 
i nn Stand-alone Restore in VM Environment ............0......... 075" 
OSS AN se ici he eae Ae a hd Mo es tals pag aes 77 


© Copyright IBM Corp. 1988, 1991 1X 








X DFDSS: Messages 

















R 5 : ag fa eres bay ae e : Pereeee tee ee ee 
Se gee eS UL HER ISR NNR a Ot Sen ORM be SB ye eatin 
MIO ES wns Se 2¥y Saf dio PU EPO Se 


ROE fate ke 
SPE a ae Pe 





Pag: Sra SDP 08 tot 
abled ARS Pc ht Oe Pee 


* oy ete , xs 
ee $03 ee een ca 









epee aN USES A kt Ce: 7 yew 















2 te. _ =  & ee ee ee oe oe E ea SE EB te Sai Sg AA RICE asa 

4% . Seteteae ; : are BI RS ce BY atalianc dha NA he ped LOMA oo) 
s MT sae 

Summary of Changes | 














a eet © . ee he Say ‘ Miya ct Bets BR a one pei 
,-Version 2 Release 5, June-19§ =" setae 
| This June 1991 revisid is provided to incorporate technical 
| and editorial changes 4n addition to the changes, 
| Appendix A, “Use off75 has been added. | 
Version 2 Release 5, Decemb te 
DFDSS Version 2 Refal storage management facilities and oe 
enhancements to help ; : ; ; : oO 
che Hea Be ee et ies, ene: seca 
| MVS/DFP Versidgdes a specially designed data set, sa 


called a partitioneSE). DFDSS supports the PDSE, : 
which offers signifpartitioned data set (PDS). DFDS 





also provides newg?DS to a PDSE and a PDSE to a | ee 
PDS. j | tc auptt Sete thele 
This support requf 3 Release 2 or a later release. Sera Ge eet gS ae 


« Use new applicatid 
New options for als further enhance the interaction 
between DF DSS qn at the data set level. DFDSS passes 
control to the useqIM) when a data set is selected and 
when the processismpleted. At these exit points, the 
UIM can performdr example, you can customize the . 
UIM to end proce to bypass options such as serialization 
and security verific. 


| * Process data sets thualifier of SYS1. By using the 
PROCESS(SYS1) 


| — Release unusesor sequential data sets that have a : 
| high-level qual : 
| — Move data setil qualifier of SYS1. 


| — Specify the DE the DUMP command to dump and 
| delete data setgl qualifier of SYS1I. 


— Replace oreallhave a high-level qualifier of SYS1. | 


i , 
* Process data sets ttSORG. By using the 
PROCESS(UND ord, you can copy or restore undefine 
DSORG data aay has a larger track capacity. 


* Specify both the O OMPRESS keywords for dumps. 


wich gnegnateesiaie ste tiene = 


You no longer mugfformance (by specifying OPTIMIZE) 
or saving space (b IESS). You can back up data by using 


both keywords. 


ent eho 


¢ Reduce CPU time}ta-compression algorithm during 
DUMP. 
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° Use stand-alone RESTORE to restoré compressed dump data...) 


| | * Reduce I/O to the VSAM volume data set’ ‘(VVDS) during logical data set 
| oo DUMP/RESTORE, data set COPY, and CONVERTV. 


¢ Declare a larger block size for a SYSPRINT data set or for the output data set 
es the PRINT command. 


Aa, E aoe es ; / 7 és ee othe = ee subsp suse ras ee we ee ‘egtae pie wed SERGE wg vary 
Se on ee MBE UAS medic SESS br ane a PONE 
DFDSS now allows a block’ size greater than 8 a - ‘elit: 


| ¢ Perform authorization checking during RESTORE for data sets that have not 
| been preallocated. 


¢ Specify the target status of SMS-managed generation data sets. 


Le | © Relieve virtual storage constraints by moving DFDSS internal control blocks. . 
| above the 16M byte line. 


Version 2 Release * Eocene iste 


Storage enedemen Subsystem (SMS) Sassen 
When processing a data set, DFDSS recognizes and preserves the data, 
management, and storage classes associated with the data set. 


¢ COPY and DUMP/RESTORE commands move data sets between 
SMS-managed and non-SMS-managed volumes. 


« The new CONVERTV command converts volumes to and from SMS 
management without data movement. 


¢ DFDSS allows data set selection based on data, management, and storage class 
names. 


¢ The new INCAT keyword allows DFDSS to locate source data sets cataloged 
outside the standard search order for COPY, DUMP, and CONVERTYV. This 
keyword can be used in place of JOBCAT/STEPCAT statements, which are 
prohibited when processing SMS-managed data sets. 


Functional Enhancements 
¢ The new SPHERE keyword allows DFDSS to move an entire VSAM sphere 
(base cluster and all associated alternate index clusters and paths) with one 
invocation of COPY, DUMP, or RESTORE. 


* DFDSS COPY and RESTORE have the capability to allocate multivolume 
VSAM target data sets. 


¢ The % character acts as a place holder for DFDSS data set name filtering. 
¢ DFDSS reblocks data sets that have the reblockable indicator set on. 


* The REBLOCK keyword (already supported for COPY) is supported for 
logical RESTORE. 


¢ Multiple arguments for filtering criteria can be specified on the BY keyword. 


¢ A new application interface exit point (EIOP20) has been added. DFDSS 
passes control to this exit when a data set is allocated by DFDSS during a 
physical data set RESTORE operation. 


¢ When DFDSS (COPY or logical RESTORE) detects an underallocation of the 
| non-VSAM target data set on an unlike device, it estimates the amount of 
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additional space needed and extends the data set accordingly. The copy or 
restore then continues, using the additional space. 


Summary of Changes Xilll 
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Chapter 1. How to Read DFDSS and Stand- Alone DFDSS 
Restore Messages 


- ~~" DEDSS Gonsists of two programs: ER 
System DFDSS, which runs under the MVS system environment. Chapter 2, 
“System DFDSS Messages” lists system DFDSS messages. 


Stand-alone DFDSS restore, called ADRDMPRS, which runs independently of 

the MVS system environment. ADRDMPRS is limited to one function—a full 
| or partial (tracks) restore from a physical dump tape. Chapter 3, “Stand-Alone 
| DFDSS Restore Messages” lists ADRDMPRS messages. 


How This Book Explains Messages 
Each DFDSS message, whether system or stand-alone restore, is accompanied by: 


e An explanation 

« A description of the system action 

« A suggested programmer response 

« A suggested operator response 

e A reference to items in the problem determination table. 


Refer to Chapter 4, “Problem Determination Table” on page 73 for an explanation 
of the problem determination codes listed in the messages. 


The Format of System DFDSS Messages 
ADR is the component name for DFDSS messages, and ADRDSSU is the program 
that produces the messages. For programmers, ADRDSSU produces the messages 
in the SYSPRINT data set, and for operators, by way of the console. The format 
of messages written to SYSPRINT: 


ADRnnnt (xxx)-mmmmm(yy), message text 
The format of messages wnitten to the console: 


zzADRnnnt (xxx)-mmmmm(yy), message text 


Figure 1 illustrates the format of a system DFDSS message. 
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Message reply ID. 
Standard 3-character beginning 
Message number 


Console operator type code or 
SYSPRINT message severity code 


Taskid of the requested function 


Diagnostic information 


zzADRnnnt = (xxx)-mmmmm(yy), INSUFFICIENT STORAGE AVAILABLE 
TO SCHEDULE TASK 





Figure 1. Format of a System DFDSS Message 


Standard character representations for system DFDSS messages are: 


ZZ Message reply identification (absent if reply is not required). 

ADR Standard 3-character prefix. 

nnn Message number. This three-digit number is unique to each 
message. 

t Type code. This 1-character code identifies either the console 


operator type or the SYSPRINT message severity. For console 
messages, the types are: 


A Action: Operator must perform a specific action. 
D___siDecision: Operator must choose an alternative action. 


I Information: No operator action is required. 
W Warning: No operator action is required, but an error 
occurred. 


For SYSPRINT messages, the type code indicates the severity: 


I Informational message. 

W Warning message. Task continues, but an error occurred. 

E Error message. The particular task might end or might 
continue without completing all requests. 

T Termination message. DFDSS ends. 


(Xxx) The taskid of the requested function. For each function requested in 
the input control statements, a taskid is assigned. Each message 
related to a task contains this taskid in the message. If the message is 
general (that is, not relating to a particular function), this field is 
omitted. 


mmmmm(yy) Diagnostic information used by IBM service Poa as an aid 
in problem determination. 
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DFDSS messages. 
DFDSS and 
Messages” for an 


Seis 


EN FAILED FOR 


ame does not exist or is 
inted ifa SYSPRINT DD 
Sage) is not found or 


:turn code is 12. 

: error. Verify that a 

) DD statement is present 
submit the job. 


ee 


‘s 1, 2, 3, 13, and 29. 


UFFICIENT MAIN 
~E TO INITIALIZE 


ze was available to 
DFDSS.. Message _. 
cate the storage needed. 
: return code is 12. 

- error. One of the 


B or EXEC statement io 
sage ADRO/8I, and 


fied, increase the 
not exceed ine storage 


31,3, 4, 13, and 29. 


R ABEND 0001 WILL 
JRRENCE n OF 


Intains the ABEND = 
2 nth occurrence of the 


antil the nth occurrence 
If the message is noi 


SYSIN FILE 

(or acceptadie 

the job stream. 

return code is 12. 
error. Make certain a 
etry the job. 


53,413, and 29. 


ADROO09T 





(xxx}mmmmni(yy), date time EXECUTION 
{BEGINS|ENDS|HALTED} 
Explanation: This message gives the date and time a particular 
task begins or ends , Processing. mene an FS Merten get ee EE 
System Action: “None.*! 7?" eS ne 
Programmer Response: None. 
Operator Response: None. 
Problem Determination: None. 


ADROO6I 





ADRO07E (xxx}mmmmm(yy), TASK CONTAINS AN 
INVALID NUMBER OF I/O FILE REQUESTS 
Explanation: ‘The number of input and/or output files specified . 
in the control statements was incorrect. The following are 


possible conditions: 


* A full or tracks RESTORE or COPY did not have exactly 
one input and one output file. 


¢ A full or tracks DUMP had more than one tapes vO ES 
"© ‘A DEFRAG function specifi ed more than one volume. 


System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 


8. 


Programmer Response: ~ Correct the statement, and rerun the 
job. 
Operator Response: None. a 
Problem Determination: Table I, items 1, 3, 4 13, 20, and 29. 


ADROO8E (xxx}mmmmm(yy), INSUFFICIENT STORAGE 
AVAiLABLE TO SCHEDULE TASK 
Explanation: Insufficient storage space was available for this 
function. Message ADROI8I follows this message to indicate 
the storage for this task. 

System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 
3. 

Programmer Response: Probable user error. Correct the error 
as indicated by message ADROI8I, and resubmit the job. 
Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


(xxx}-mmmmm(yy), INVALID {LINECNT | 
SIZE | TYPRUN | PAGENO | ABEND | 
AMSGCNT | TRACE | UTILMSG | XABUFF | 
RACFLOG} VALUE SPECIFIED IN PARM 
STATEMENT 

Explanation: The indicated parameter on the EXEC statement 


was incorrectly specified. 


* A LINECNT value must be between | and $999. 
* A SIZE value must be less than or equal to 9999K bytes. 


* TYPRUN must be TYPRUN =SCAN or 
TYPRUN =NORUN 


* A PAGENO value must be between 0 and 9999. 

* An ABEND value must be between 0: and 999. 

* An AMSGCNT value must be between | and 9999, 
* A TRACE value must be YES or not specified at all. 
* The UTILMSG value must be either YES or NO. 


* The XABUFF value must be either ABOVEI16 or 
BELOWI6. 


me Seat wT ate, 


‘System " Action: The job ends. “The return “code‘is 12.” 


Programmer Response: _Make sure that the indicated value is 
valid. Check for keypunch or spelling errors. Correct any . 
errors, and resubmit the job. 

Operator Response: None. 

Problem Determination: Table I, items |, 3,4, 13, and 29. 





-*“ADROIOI =’ “(xxx}mmmmm(yy), SIZE VALUE OF size WILL ** -” 


BE USED FOR GETMAIN 
Explanation: This message indicates the value of the SIZE 
parameter that the requester specifies. The value does not 
include the storage acquired by the programs or utilities that 
DFDSS calls. 
System Action: The storage used by DFDSS will not exceed 
the indicated value. 
Programmer Response: None. 
Operator Response: None. 
Problem Determination: None. 





ADRO1I11 (xxx}>mmmmm(yy), LINECNT VALUE OF 


linecount WILL BE USED 


. Explanation: This message indicates the value of the 
-" LINBCNT parameter that the requester specifies. 


System Action; SYSPRINT output will be printed at the 
indicated lines per page. If a value of 999¢ is specified, no page 
eject occurs. 


‘Programmer Response: .. None. - 


Operator Response: None. 


fo Pemuranons N one. 





ADRO12I (xxx}-mmmmm(yy), date time DFDSS 
PROCESSING COMPLETE. HIGHEST 
RETURN CODE IS re [FROM:] 

Explanation: This message :s :ssued after 2 DFDSS job step. 
completes. The hignest concit:cn code (N{AXKCC) set during 
the job step is printed (see message ADR2i31) and returned to 
the DFDSS invoker in register 15. If the highest condition 
code is not zero, a list of the tasxs competed with that code is 
printed. If the highest condition code is -eceived from the 
syntax checking of the contro. statements. -he word SYNTAX 
is printed. If the highest condition code is generated by a SET 
command, the words SET COMMAND 2:2 printed. 

System Action: None. 

Programmer Response: Nore. 

Operator Response: None. 

Problem Determination: Nore. 


ADRO131 (xxx}mmmmm(yv), date time TASK 
{COMPLETED: ABENDED} WITH 
(RETURN| Sr oreM ABEND| USER ABEND} 
Explanation: [f the commanc cid not atend, the value nn is 
the condition code generated curing processing of the 
command. If the command a>ended, the abend code yyyy is 
also printed. The system atend code is in hexadecimal, and the 
user abend code is in decima:. 

System Action: [f the command abendec, LASTCC is set to 8, 
or itis settonmn. If MAXCC is less than LASTCC, MAXCC 
is set so it is equal to LASTCC. 

Programmer Response: Nore. 

Operator Response: None. 

Problem Determination: If the command did not abend on a 
user-requested 001 abend, see System Codes. 
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Problem Determination: “fable 1: tee t. ey 4 43; 00); “and 29. 





ane (a ane: date time ALL 


R ad PUES pice eb pan 


ae “PREVIOUSLY SCHEDULED TASKS. 7°“ 
COMPLETED. (SERIAL|PARALLEL} I MODE 
NOW IN EFFECT 

Explanation: A switch was made from serial mode to parallel 

mode or from parallel mode to serial mode (at the request of 

the user in the control statement or by the installation-wide 

options exit routine). 

System Action:,. All previously scheduled tasks.¢ either. FUBRING opine 


“or waiting to ‘run have’ ‘completed: ‘Processing’ continues, © = #*a*. 


Programmer Response: None. 
Operator Response: None. 
Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 





(xxx+mmmmm(yy), {MAXIMUM CONDITION 
CODE|RETURN CODE OF TASK} HAS 
BEEN RESET. FROM rel TO re2_ 
Explanation: “A SET command was encountered and 
successfully reset a condition code. The text indicates which 
taskid was affected, what the return code was before and after 
the reset, and to what the return code was reset. 

System Action: None. 
Programmer Response: Nene 
nse: ~ “None. * 


ADROI1SI 


gin Bak) eee “te 


(xxx}mmmmm(yy), RACF LOGGING Orton 
_ + a. > IN EFFECT FOR THIS TASK”. 
Explanation: RACF logging for volume and daa ‘set 
authorizations by DFDSS will be performed in accordance with 
the resource profile specifications: The option is ‘in effect 
because RACFLOG = YES was specified or the 
installation-wide options exit forced it. 
System Action: None. 
Programmer Response: None. 
Operator Response: None. 
Problem Determination: None. 


ADRO161 


ADROI7E (xxxX+}mmmmm(yy), TASK NOT SCHEDULED 
DUE TO ERROR. TASK RETURN CODE rc 
error 

System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 
8. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADRO18I (xxx+}mmmmm(yy), STORAGE REQUIRED nk. 
STORAGE AVAILABLE nk 

Explanation: A task was not performed or the job did not 
start because of lack of storage. This message follows either 
message ADROO2T or ADROO8E and indicates the 
approximate amount of storage required when the job is rerun. 
The values refer only to the failure indicated in message 
ADROO2T or ADROO8E and do not take into account storage 
required for subsequent task scheduling. 

System Action: Message ADRO002T or ADROO8E indicates the 
return code and system action. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 
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ADROI9E .....(xx}>mmmmm(yy), THE. {INPUT|OUTPUT} 

' FILE HAS AN INVALID DEVICE TYPE FOR 
- THE COMMAND SPECIFIED 

Explanation: The DASD device is not supported for the 
command specified. 

System Action: The task is not Spent peseesing 


continues with the next control statement. The return code is 


‘ 8. b on ae Fy » 4 ~, rae . 
“ Programmer Response: Probable user error. Correct the *~- 


error, and resubmit the job. 
Operator Response: None. 
Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADRO020E (xxx}>mmmmm(yy), DDNAME ddname NOT 
FOUND 
Explanation: A ddname specified in a DFDSS control 


statement has no corresponding ddname in a DD statement. 
Either a necessary DD statement is missing, or a ddname is 
misspelled in an existing DD statement. 

System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 
8. 

Programmer Response: Probable user error. conse ane 
error, and resubmit the job. ; — 
Operator Response: None. 

Problem Determination: Table I, items 1, 3,4, 13, 20, and 29. 


ADROZ21iI (xxx}mmmmm(yy), THE ALLOCATION OF 
THE MESSAGE DATA SET HAS FAILED. 
DYNAMIC ALLOCATION ERROR CODE: 
eeee, INFORMATION CODE: iii. MESSAGES 
WILL BE SPOOLED TO SYSPRINT. 
Explanation: DFDSS attempted to allocate a temporary data 
set to store task-related messages. If the WORKUNIT or the 
WORKVOL parameters, or both, were specified, they wiil be 
used to allocate the temporary data set. The error and 
information codes are returned by dynamic allocation. The 
codes are listed in OS/VS2 MVS System Programming Library: 
Job Management, or in MVS Extended Architecture Sysiem 
Programming Library. System Macros and Facilities, Volume 1. 
An undocumented error code may be displayed if an 
installation-wide validation exit is used to deny dynamic 
allocation but fails to get a reason code returned by dynamic 
allocation. 

System Action: Messages may not be grouped according to 
task, if DFDSS is running in parallel mode. The return code is 
0. 

Programmer Response: Correct the problem as indicated by 
the error and information codes, or specify a different volume 
or esoteric name with the WORKUNIT and/or WORKVOL 
parameters. 
Operator Response: 
Problem Determination: 


None. 
Table I, items 1, 3, 4, 13, 20, and 29. 


ADR0O22T (Xxx>mmmmm(yy), INVALID DCB SPECIFIED 
FOR {SYSPRINT|ddname} 

Explanation: The DCB for the SYSPRINT file (or its 
acceptable alternative) must have a RECFM of VB or VBA. 
The logical record length (LRECL) must have a value between 
84 and 137. The BLKSIZE must have a value of at least 4 
greater than the LRECL. The actual printed line will be 5 less 
than the LRECL. If the LRECL is greater than 137, it is 
changed to 137 and message ADRO30W is printed. 

System Action: The job ends. The return code is 12. 
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Programmer Response: Probable user error. Coreect the 
error; and resubmit the job:“The’ BLKSIZE, LRECL,‘and ~ 
RECFM need not be specified and can default. If they are 
specified, RECFM must be VB or VBA; LRECL must be 
between 84 and 137 (inclusive); and BLKSIZE must be at least 
4 greater than the LRECL. 

Operator Response: None. 


Problem Det APa ANON: Table I, items 1, 2, 3, 4, 13, and 29. 


ad 


““" ADRO24E 


Tay wes 


. ay eae TRACKSIOUTTRACIS 
VALUE IS INVALID FOR DEVICE. VALID 
CYLINDER RANGE IS 0 TO ccee. VALID 
TRACK RANGE IS 0 TO hhhh 

Explanation: Invalid for the specified device types are: (1) the 
range specified in the TRACKS keyword of a DUMP, COPY, 

RESTORE, or PRINT, or (2) the range specified for the 

OUTTRACKS keyword for COPY or RESTORE. The 
TRACKS values must fall within the cylinder and track range 
indicated in the message. The cccc and hhhh are high cylinder 
and head numbers, respectively, in decimal notation. 

System Action: The task ends. Processing continues with the 
next control statement. The return code is 8. 

Programmer Response: Correct the error, and rerun the job. 
Operator Response: None. - . 
Problem Determination: Table I, items 1, 3. 4, 13, 20; -and 29. 


ADRO025E (Xxx}mmmmm(yy), (INPUT;|OUTPUT} 


DEVICE TYPE IS INVALID FOR TASK 


- Explanation? The input or output device type for the command 


is not allowed. For a DUMP or a CONVERTYV, input must 
be DASD. For a RESTORE, output must be DASD. For a 
COPY, both input and output must be DASD. For a PRINT, 
input must be DASD. For a DEFRAG, the volume must be 
DASD. 
System Action: 
continues with the next control statement. 
8. 

Programmer Response: 
command. 
Operator Response: 
Problem Determination: 


The task is not performed. Processing 
The return code is 


Correct the error, and reissue the 


None. 
Table I, items i, 3, 4, 13, 20, and 29. 


ADRO26E (xxx}mmmmm(yy), {volser;ddname} IS INVALID 
AS OBJECT DDNAME 
Explanation: A reference was made to an incorrect ddname. 


The following restrictions apply to DD references from the 
control staternents: 


¢ SYSPRINT (or its alternative) can be referred to only from 
the PRINT command. 


¢ SYSIN (or its alternative) cannot ce referred to at all. 


¢ The indicated volser was specified more than once for the 
INDYNAM parameter on a COPY, CONVERTY, or 
DUMP command. 


¢ The volser associated with the indicated ddname was 
specified more than once for the INDDNAME or 
OUTDDNAME parameter on a COPY, CONVERTYV, or 
DUMP command. 


System Action: The task ends. Processing continues with the 
next control statement. The return code is 8. 

Programmer Response: Correct the error, and reissue the 
command. 
Operator Response: 
Problem Determination: 
29. 


None. 


Table I, items !, 2, 3,4, 13, 20, and 
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““ADRO27T | (xxx}-mmmmm(yy), DFDSS IS NOT 
ae SUPPORTED BY THE CURRENT SCP . 
Explanation: DFDSS performs only on MVS/370 with DFP, 


MVS/XA,.and MVS/ESA. ‘The system identification in the’ 
~ nucleus is not one of these. . 
System Action: The job ends. The return 
Programmer Response: 


code is 12. 
If the system is one of the above, 


2 st sCOrrect the system identification i in the nucleus, ‘and resubmit « © 


ihe lob” 
Operator Response: None. 

Problem Determination: Table I, items :, 3,4, 13, and 29, 
Obtain a dump of the CVT in the nucleus, and contact IBM. 


ADR0O28I (xxx}>mmmmm(yy), TYPRUN =SCAN 
REQUESTED. ONLY CONTROL CARD 

ie SYNTAX CHECKING WILL BE DONE 

Explanation: No tasks will be performed. Only checking of 


the input control statements will be done. 

System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3,4, 13, and 29. 


(xxx}mmmmm(yy), KEYWORD PRECEDING 
POSITION nn IN PARM STATEMENT IS 
INVALID 

Explanation: In the EXEC statement, the keyword preceding 
the = sign in the indicated position of the parameter of the 
PARM keyword i is not recognized as a valid keyword epHon: 
“System Action: The job ends. The return code is 12. 
Programmer Response: Correct the errcr in the PARM 
statement, and rerun the job. The valid sarameter keywords 
are shown in the DFDSS: Reference. 
Operator Response: None. 

Problem Determination: Table I, item 


ADRO029T 


3,4, 13, and 29. 


ADRO30W = (xxx}mmmmm(yy), DCB VALUES HAVE 
BEEN MODIFIED FOR ddname 

Explanation: In the DCB information ycxu specified, either th 
LRECL or the BLKSIZE value was outs:ce the allowable 
range. The LRECL and the BLKSIZE are set to default values 
of 137 and 141, respectively. 

System Action: The job continues with 
the ddname. The return code is 4. 
Programmer Response: In the future, supply a correct DCB or 
let the DCB for the ddname default to its ailowable values. 
Operator Response: None. 

Problem Determination: Table I, items :. 


tne modified DCB for 


3,4, 13, and 29. 


ADRO311 (xxx+}mmmmm(yy), TYPRUN = NORUN 
REQUESTED. TASKS WILL EXECUTE IN 
NORUN MODE 

Explanation: TYPRUN=NORUN was specified in the EXEC 
Statement parameter. Subtasks will run i: NORUN mode. 
System Action: All subtasks except CONVERTV, DEFRAG, 
and data set DUMP and RESTORE wii. bypass processing. 
Data set DUMP and RESTORE will perZorm only data set 
filtering and will not perform DUMP or RESTORE functions. 
CONVERTYV will perform data set filter:ng and volume and 
data set eligibility tests, but wiil not actualy convert any 
volumes. DEFRAG will print the fragmentation index but will 
not relocate data set extents. Message ADRO4OI for the 
scheduled tasks follows this message. 

Programmer Response: None. 


8 DFDSS: Messages 


we 


- Operator Response: . 









ee 
Pa lan Mine 


«Operator: -Response: #-None te asada eee. 


SR PARR abe a 


‘Problem “Determination: Tevet, items 1, 3, 4, 13, 20, and 29. 


ADRO33W = (xxx}mmmmm(yy), INSUFFICIENT STORAGE 
AVAILABLE FOR OPTIMIZE n. OPTIMIZE 
n-1 WILL BE ATTEMPTED 

Explanation: Not enough storage was available to schedule the. 


‘function with.the indicated OPTIMIZE, value.:«The OPTIMIZE - 


value is reduced by 1,'dnd another’ ‘attemipt” is made. This” °” * 
message can appear more than once as the OPTIMIZE value is 
decreased. 

System Action: The function performs with a reduced 
OPTIMIZE value. The return code is 4. 

Programmer Response: For the next run, either reduce the 
OPTIMIZE value in the control statement or increase the 
available storage. 

None. » 

Problem Determination: Table I, items :1, 3,4, 13, 20, and 29. 


ADR0O35I (xxx>mmmmm(yy), INSTALLATION EXIT 
ALTERED keyword { DEFAULT | REQUEST | 
OPTION | VALUE }[TO xxxxx] 

Explanation: The installation-wide options: exit‘routine has ~ 
changed the default or requested option or value to that 
indicated in the message. See the Data Facility Data Set 
Services: Reference under “Coding Installation-wide Exit 
Routines” for details. 

System Action: The DFDSS ‘function will, run’ with the altered 
options. 

Programmer Response: Check with your system, programmer . 
for the exit routine operation to get the desired result. 
Operator Response: None. 

Problem Determination: Table I, items 1, 3,4, 13, 20, and 29. 


ADRO36W = (xxx}mmmmm(yy), TASK NOT SCHEDULED 
AT REQUEST OF INSTALLATION EXIT 
Explanation: The installation-wide exit requested that this task 
not be performed. 

System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 
8. 

Programmer Response: Check with your system programmer 
for restrictions placed by the exit. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADRO037E (xxx}mmmmnr(yy), FAILURE WHILE 
ATTACHING TASK, [ATTACH RETURN 
CODE IS re | INSUFFICIENT STORAGE TO 
ATTEMPT ATTACH] 

Explanation: A task could not be attached because one of the 


following conditions existed: 


* The system-attach macro returned a nonzero return code 
while attaching a task. Probably not enough storage was 
available to attach the task. 


¢« Not enough storage was available to even attempt the 
attach for the task. 


System Action: Processing is attempted on other tasks. Final 
return code is set to 8. 

Programmer Response: Either increase the region size, specify 
a smaller size parameter, or both, then rerun the job. 
Operator Response: None. 


Problem Determination: Table I, items 1, 3, 13, 29, and 35. 





Eagh stad. 
rt OR pea yea 
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(oa ceasiarayy) RELEASE. FUN CTION 

. NOT AVAILABLE” ""* 

Explanation: DFDSS determined from the CVAF table that . 
no CVAF PARTREL macro BEUBPOH is installed on your 

: -system. 

System Action: The task is not performed. Bistecing 
continues with the next control statement. The return code is 
8. 

Programmer Response: None. 220% 

Operator Response: Noneo°° “ ~~ 7) 0 er 
Problem Determination: None. 





_ ADR038E 
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ADR040I (xxx-mmmmm(yy), PROCESSING BYPASSED 
DUE TO NORUN OPTION 

Explanation: Further processing is bypassed because 
TYPRUN =NORUN was specified in an EXEC statement 


parameter. This option results in the following: 
* COPY FULL/TRACKS—Task ends. 


* COPY DATA SET—Filtering is performed and the names 
of the selected data sets are printed; data sets are not 
copied. 


° COPYDUMP—Task ends. 


° DEFRAG—Only volume statistics are mented: dats set 
extents are not relocated. 


* DUMP FULL/TRACKS—Tasx ends. 


8 DUMP DATA SET—Filtering is performed and the names 
of the selected data sets are printed; data sets are not 
dumped. 


@ PRINT—Task ends. 
¢ RESTORE FULL/TRACKS—Task ends. 


* RESTORE DATA SET—Filtering is performed and the 
names of the selected data seis are printed; data sets are 
not restored. 


* COMPRESS and RELEASE—Filtering is performed and 
the names of the selected data sets are printed; data sets are 
not restcred. 


System Action: Further processing :s bypassed for the volume 
or task. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3,4, 13, 20, and 29. 


ADRO4I1I (xxx}+mmmmm(yy), [/O BUFFER 
{ABOVE|BELOW} 16MB VIRTUAL 
REQUESTED 

Explanation: You requested that the DFDSS I/O buffers 
reside above or selow 16 megabytes virtual address. 
System Action: If you requested that buffer storage reside 
above 16 megaoytes virtual address, DFDSS will attempt to 
allocate storage for the buffers above 16 megabytes virtual 
address. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 






vo. ADRO@20 


«~~ Programmer Response:' “None. 52" 


- ADR1021 
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(oco-mmmmm (yy), (1/0 | APPLICATION 
INTERFACE} BUFFER WAS OBTAINED 
iss BELOW 16MB VIRTUAL ADDRESS © 
Explanation: Not enough storage was available above 16 


“megabytes virtual address to satisfy the buffer request.. Under 


MVS/370, this message is issued if you specify ABOVE16. 
System Action: The buffer is obtained below 16 megabytes 
virtual address, and-DFDSS oe conniaues. 


aaa he 


ys ew oe i i z o fees 





Operator Response: ‘None. 
Problem Determination: Table I, iterns 1, 3, 4, 13, 20, and 29. 


ADR1O011 (xxx}>mmmmm(yy), TASKID xxx HAS BEEN 
ASSIGNED TO COMMAND ‘yyyyyyyy?’ 
Explanation: The indicated taskid was assigned to the indicated 


command. All future messages related to this command will 


contain the indicated taskid following the message number. 


System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, iterns 1, 3, 4, 13, 20, and 29. 


(xxxX}+>mmmmm(yy) COMMAND BYPASSED 
DUE TO CONDITION CODES 

Explanation: An IF-THEN-ELSE command sequence caused 
the command to be bypassed. When you specify an 
IF-THEN-ELSE command sequence, either the THEN or the 
ELSE clause is performed, and the one not performed is. ~ 
bypassed. 

System Action: The bypassed portion of the command .. 
sequence is checked for syntax errors but is not performed. 
DFDSS processing continues. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table [, items 1, 3, 4, 13, 20, and 29. 


ADR103W = (xxx+}mmmmam(yy), A ‘DO’ OR ‘END’ WAS 
ENCOUNTERED OUTSIDE OF AN 
IF-THEN-ELSE TEST 

Explanation: A DO was encountered without a preceding 
IF-THEN-ELSE test. 

System Action: A DO encountered when there is no 
IF-THEN-ELSE in effect does not cause DFDSS to take 
special action. However, it must have a matching END 
command. DFDSS processing continues. The return code is 4. 
Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADRIO4E (xxx+mmmmm(yy), AN [VIPROPERLY 
PLACED COMMA HAS BEEN 
ENCOUNTERED 

Explanation: An improperly placed comma was found in 
scanning the command. Commas cannot indicate the omission 
of positional parameters. The omissicn of leading positional 
parameters is not permitted. 

System Action: The command is not performed. Processing 
continues with the next control statement. The return code is 
8. 

Programmer Response: Correct the command syntax, and 
reissue the command. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 
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~ ADR10SW’ - (xxx)-mmmmim(yy), COMMAND-END)* 


DELIMITER APPEARS WITHIN 
APOSTROPHES cael 
Explanation: A quoted string contains the optional command 
delimiter (a semicolon). A closing single quotation mark might 
be omitted. 
System Action: The usage is accepted, and the semicolon is 
:. treated as: a valid character instead , of. a delimiter. The, return | 
- code is 4.0 ny Sea igh Pe 
Programmer Response: Check the usage af the ssaleoion, and 
correct if necessary. 
Operator Response: None. 
Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR106W = (xxx}mmmmm(yy), TOO MANY RIGHT 

He PARENTHESES FOUND. EXCESS IGNORED 
Explanation: Too many closing parentheses were found at the 
end of the command or following a first-level parameter. 
System Action: The excess is ignored, and the processing is 
continued for the command. The return code is 4. 

Programmer Response: Remove the excess parentheses. 
Operator Response: None. 


-.” Preblem Determination: Table I, items 1, 3, 4,13, 20, and 29. . 


| ADR107E = (xxx}mmmmm(yy), TOO FEW RIGHT 
PARENTHESES FOUND AT END OF 
-COMMAND _. 
Explanation: Too few closing parentheses were ound at the 
end of the command to properly close the subparameter lists. 
- This message may also be issued when the continuation 
character is omitted in a list of subkeywords. 
System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 
8. 
| Programmer Response: Correc: the comm 
| reissue the command. 
Operator Response: None. 
Problem Determination: Table [, items 1,3, 4, 13, 20, and 29. 


and syntax and 


ADR1O08I (xxx}+mmmmm((yy), date time EOJ 
ENCOUNTERED. ALL TASKS WILL 
QUIESCE 

Explanation: An EOJ command was encountered. A 
subsequent message, ADRO13]1, indicates when all tasks are 
completed. 

System Action: After performing tasks before the EOJ 
command, DFDSS ends. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


| ADR109I1 (xxx-mmmmm(yy), date time INITIAL SCAN 
OF USER CONTROL STATEMENTS 
COMPLETED 
Explanation: A{l control staternents were scanned for correct 


function name and IF/DO/END balancing. 

System Action: Processing phase now begins. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Tabie I, items 1, 3, 4, 13, 20, and 29. 
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- Operator ‘Response: None. ead 
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“ADRI10W: » (xxx}mmmmm(yy), WRITE TO OPERATOR »~..... 


MESSAGE HAS BEEN TRUNCATED ~ 


' Explanation: A WTO command longer than 72 characters was 
- encountered. 


System ‘Action: ‘The excess was truncated although. the WTO 
was issued. The return code is 4. 

Programmer Response: Shorten the WTO text, or issue 
multiple WTO commands. to accommodate et text, 





Problem Determination: Table 1, ore a es oy 20, “and 29." 


ADR120E (xxx+>mmmmm(yy), TOO MANY POSITIONAL 
PARAMETERS AFTER ‘xxxxx’ 

Explanation: Too many positional parameters are specified 
following the characters xxxx for a parameter list. 

System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 
8. 

Programmer Response: Remove the excess parameters from 
the command, and reissue the command. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


See SE RETO Bate MINE Ege deg ee agile Oe aot 


(xxx+mmmmm(yy), CONSTANT xxxxxxxx? 
EXCEEDS CHARACTER LENGTH LIMIT 
Explanation: The indicated constant contains more characters 


. than the maximum permitted by the command syntax. 


System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 
Programmer Response: Correct the constant, and reissue the 
command. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR122E (xxx}mmmmm(yy), INCORRECT NUMBER OF 
CONSTANTS/ENTRIES IN LIST 
BEGINNING AT ‘yyyy’ 

Explanation: An incorrect number of constants (or entries) 
was found in the list beginning at yyyy. 

System Action: The command is not performed. Processing 
continues with the nex: control statement. The return code is 
8. 

Programmer Response: Correct the command syntax, and 
reissue the command. 

Operator Response: None. 

Problem Determination: Table [, items 1, 3, 4, 13, 20, and 29. 


ADR123E (xxx-}mmmmm(yy), ITEM ‘xxxx’ DOES NOT 
ADHERE TO RESTRICTIONS 

Explanation: The indicated parameter does not conform to the 
required naming conventions. For example, a ddname contains 
invalid characters. Check the password data set for syntax 
errors. 

System Action: The task is not performed. Processing 
continues with the next contro] statement. The return code is 
8. 

Programmer Response: Correct the parameter error, and 
reissue the command. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 
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ADR124E ~~ 


(xxx}mmmmm(yy),; DELEMITER ‘xxxx’ IS NOT 
PROPERLY PRECEDED BY A CONSTANT 
OR KEYWORD —- 
Explanation: A delimiter was found where a subparameter list 
or data was expected. The delimiter is improperly used. 
Parentheses might be improperly positioned, or a positional 
parameter might be missing. 
_ System Action: The task i is not performed. Processing .’ 


“=¢ontinues with the next control statement: The return code i is 


8. 

Programmer Response: Ccrrect the syntax error, and reissue 
the command. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR125E (xxx}>mmmmm(yy), LEFT PARENTHESIS 

; MISSING FOLLOWING KEYWORD ‘xxxx’ 
Explanation: An opening parenthesis, which should begin the 
required subparameter list or value associated with the 
command keyword, does not follow the keyword xxxx. 
System Action: The task is not performed. Processing 
continues with the next control statement. The return Coes is 
Programmer Response: Check A requisementé of the 
keyword, correct the syntax, and reissue the command. 
Operator Response: Nore. 

Problem Determination: Table I, items 1,3, 4, 13, 20, and 29. 


ADR126E (xxx}mmmmm(yy), RIGHT PARENTHESIS 

. MISSING AFTER ‘xxxx’ 

Explanation: A closing parenthesis was not found where 
expected, or a subparameter list was not properly delimited. 
System Action: The task ‘s not performed. Processing 
continues with the next control statement. The return code is 
8. 

Programmer Response: Correct the command syntax, and 
reissue the command. 

Operator Response: None. 

Problem Determination: Taole [, items 1,3, 4, 13, 20, and 29. 


ADR127E (xxx}mmmmm(yy), INVALID PARENTHESIS 
FOR SPECIFYING REPEATED 
SUBPARAMETER LIST 

Explanation: Parentheses used for delimiting repeated 
subparameter lists are missing or not matched. 

System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 
8. 

Programmer Response: 
reissue the command. 
Operator Response: Nore. 

Problem Determination: Table I, items !, 3, 4, 13, 20, and 29. 


orrect the command syntax, and 


ADR128E (xxx}mmmmm(yy), INVALID LEFT 
PARENTHESIS AFTER ‘xxxx’ 

Explanation: An opening parenthesis that appeared to delimit 
the positional parameter xxxx was found, but the positional 
parameter was not a constant or a list of constants. 

System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 
8. 

Programmer Response: Correct the command syntax, and 
reissue the command. 

Operator Response: None. 

Probiem Determination: Tabdie I, items 1, 3, 4, 13, 20, and 29. 








““(xxx}mmmmm(yy); KEYWORD ‘xxxx’ IS 
IMPROPER 

Explanation: The command contains a musspelled, improperly 

specified, or inapplicable keyword. 

System Action: The task is not performed. Processing 

continues with the next control statement. The return code is 

8. 

Programmer Response: -Correct the command, syntax, Sue 

reissue the command. *°* *"* se shee! 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR129E ” 


ADR130E (xxx}>mmmmm(yy), KEYWORD ‘xxxx’ 
APPEARS TOO OFTEN 

Explanation: The keyword xxxx appeared too often in the 
command. A parameter list might be incorrectly specified. 
System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 
8. 

Programmer Response: Correct the command syntax by 
removing the keyword, and reissue the command. 

Operator Response: None. 


. . Problem Determination: “Table:I, items 1, 3,4;'13,'20, and 29. 


ADRI31E (xxx-mmmmm(yy), ABOVE TEXT BYPASSED 


UNTIL NEXT COMMAND 


. Explanation: An error was encountered during the syntax 


check of this command, and syntax checking ended. Messages 
printed before this message indicate the nature of the error. 
System Action: Processing continues with the ‘next control 
statement. If this task was to be performed, it will not be, and 
a return code of 8 is set. If the command was being bypassed 
(see message ADRI1021), the return code is not reset by this 
error. 

Programmer Response: Correct the command syntax, and 
reissue the command. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADRi32E (xxx-mmmmm(yy), IMPROPER PASSWORD 
ENCOUNTERED AFTER ‘xxxxxxxx’ 
Explanation: A password, denoted by a slash (/), was 
encountered where a password was not allowed; an expected 
password was missing; or a password longer than 8 characters 
was specified. This is not a verification of the password but an 
error in the syntax. 

System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 
8. 

Programmer Response: Correct the command syntax, and 
reissue the command. 

Operator Response: None. 


Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR133E (xxx+}mmmmm(yy), TOO MANY REPEATED 
SUBPARAMETER LISTS APPEAR IN THE 
COMMAND 

Explanation: Too many repeated subparameter lists appear in 
the command. 

System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 
8, 

Programmer Response: Correct the command syntax, and 
reissue the command. 

Operator Response: None. 

Problem Determination: Table [, items 1, 3, 4, 13, 20, and 29. 
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~~ (xxx}-mmmmm(yy), A HEX OR BINARY 
CONSTANT IS IMPROPERLY SPECIFIED 
Explanation: A hexadecimal or binary constant is not specified 
in the correct format X'hh...hh' or B'bb...bb', respectively. 
System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 
8. 

and .. 

he are ete 
Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADRI35E = (xxx}}mmmmm(yy), IMPROPER NUMERIC 
DIGIT FOUND IN ‘xxxx’ 

Explanation: The constant xxxx contains an invalid character. 
A decimal number can be specified only with the symbolsO 
through 9; a hexadecimal number can be specified only with the 
symbols 0 through 9 and A through F; and a binary number 
can be specified only with the symbols 0 and 1. 

System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 
8. 


... Programmer Response; Correct the. commana Syntax, and 
" reissue the command. * 


None. 
Table I, items 1, 3,4, 13, 20, and 29. 


Operator Response: 
Problem Determination: 


‘(xxx}mmmmm(yy), CONSTANT $xxxxxxxx? IS 
NOT WITHIN VALUE RANGE 


ADRI36E' 


__ Explanation: . The value of the indicated constant is outside the 


‘range of values allowed for the associated parameter. 


System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 
8. 

Programmer Response: Check the command syntax for 
allowed values, correct the , then reissue the command. 
Operator Response: None. 

Problem Determination: Table I, items 1,23, 4, 13, 20, and 29. 


error 


ADRI37E (xxx}mmmmm(yy), TOO MANY 
CONSTANTS/ENTRIES IN LIST 
eda AT SxXxxx’ 

Explanation: nstants or entries are specified in 
the command BerAlAe al XXXX, 

System Action: The command is not performed. Processing 
continues with the next control statement. The return code is 
8. 


Programmer Response: Correct the command syntax, and 
reissue tne commanc. 
Operator Response: None. 


Problem Determination: Tabdie I, items 1, 3, 4, 13, 20, and 29. 


ADRI38E = (xxx>}mmmmm(yy), REQUIRED (SUB) 
PARAMETER OF ‘xxxx’ IS MISSING 
Explanation: A recuired parameter or subparameter that is 
identified by xxxx is missing. 

System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 
8. 

Programmer Response: 
the job. 

Operator Response: 


Problem Determination: 


Add the missing parameter, and rerun 


None. 


Table I, items 1, 3, 4, 13, 20, and 29. 
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> 4ADRI39E *-(xxx}-immmmnim(yy), INCONSISTENT “700-00 0°" 


PARAMETERS INVOLVING ‘xxxx’ 
” Explanation: Some commands contain parameters defined as. 
mutually exclusive. For such commands, if one parameter is... 


'- specified, the other parameter is not allowed. 


System Action: The task is not performed. Processing 
continues with the next control statement. Tne return code i is 
e Be. estoghliin « aS enone ge ei oh. ag Rate ao “ar 
“Programmer Response: - “Correct the eoiimand syntax,” and. a 
reissue the command. 
Operator Response: 
Problem Determination: 









None. 
Table [, items 1, 3, 4, 13, 20, and 29. 





ADRI40E (xxx>mmmmm(yy), INVALID ‘BY’ CRITERIA 
Explanation: A value in the BY keyword is incorrect for the 
item being tested. For example, a date may have been . ; i 
improperly specified. “ 
System Action: The task is not performed. Processing 

continues with the next control statement. The return code is 

8. 

Programmer Response: Correct the command syntax, and 
reissue the command. 
_-Operator Response: ; 
Problem Determination: 


pat he 


Nomne@ees ee Saree ARIE aS 
Table I, itertis 1” 3 4, 13, 20, and 29. 


i eenaaie (xxX}+mmmmm(yy), ERROR IN DATA: SET 
. NAME dsname . ee ienenie 
Explanation: ‘A data set name was specifi ied icorfectly: ee one 


of the following reasons: 
° The length might be greater than 44 characters. 


¢ If the data set name is not in quotation marks, a qualifier 
might be longer than 8 characters. 


* The GDG might ce :ncorrectly specified. 


System Action: The tasx :s not performed. Processing 
continues with the next control statement. The return code is 
8. 

Programmer Response: 
reissue the command. 
Operator Response: 
Problem Determination: 


Correct the command syntax, and 


None. 
Table I, items 1, 3, 4, 13, 20, and 29. 


ADRI42I (xxx-mmmmm(yy), KEYWORD yyyyyyyy HAS 
BEEN IGNORED 
Explanation: The keyword yyyyyyyy does not apply and was 


ignored for one of the fcilowing reasons: 


* LOGICALNESS—T he input data set was created by a 
logical data set DUMP. 


* WORKSIZE-—This xeyword is no longer required: 


System Action: The kev word is ignored. 

Programmer Response: Omit the keyword on future runs. 
Operator Response: None. 

Problem Determination: None. 





ADRI143E (xxx}mmmmm(yy), INVALID SYNTAX IN 
DATA SET SPECIFIED BY DDNAME ddname 
Explanation: Invalid data exists in the data set associated with 
the DD statement specified by the FILTERDD keyword. 
System Action: The tasx ends. Processing continues with the 
next control statement. The return code is 8. 

Programmer Response: Correct the parameters in error, and 
rerun the job. 
Operator Response: 
Problem Determination: 
29. 


None. 
Table [, items 1, 2, 3, 4, 13, 20, and 





ADRI44E-. (xxx}mmmmm(yy), INCOMPLETE -. | 
SPECIFICATION IN DATA SET 

* - REFERENCED BY DDNAME ddname 
_Explanation: An end-of-file condition was encountered in 
scanning the character string contained in the ddname specified 
as a PASSWORD, FILTERDD, or EXCLUDE parameter. 
This condition can be caused by incorrect continuation syntax 


or by missing records in the input stream. 


System. Action: The task is not performed. “The return code is “2: 


8. 

Programmer Response: Correct the command syntax, or add 
the missing records, then resubmit the job. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 





ADRI45E (xxx}-mmmmm(yy), KEYWORD keywordname 
MUST BE SPECIFIED ON DFP LEVELS 
PRIOR TO Vrelno. 

Explanation: The indicated keyword (keywordname) is 
required when DFDSS is run on levels of DFP before the 
indicated release (relno). 

System Action: Processing of the data set ends. The return 
code is 8. _ nets 
'- Programmer Response: “add the Keywordic or install ‘the 
appropriate release of DFP, and rerun the job. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADRISOE {xxxX+}mmmmm(yy), TASK TERMINATED DUE 
.TO INSUFFICIENT MAIN STORAGE 
Explanation: Not enough storage was available to set up the 
commands in the input stream for the indicated task. 

System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 
8. 

Programmer Response: Either increase REGION size or 
increase the SIZE parameter, or both, then retry the job. 
Operator Response: None. 

Problem Determination: Taole [, items 1, 3, 4, 13, 20, and 29. 


ADRI69T (XxxX}>mmmmm(yy), NO RECORDS IN SYSIN 
STREAM 

Explanation: The SYSIN stream was empty. 

System Action: The job ends. The return code is 12. 
Programmer Response: Ensure that the SYSIN (or acceptable 
alternative ddname) DD statement refers to a nonempty file, 
and retry the job. 

Operator Response: None. 

Problem Determination: Table [, items 1, 3, 4, 13, 20, and 29. 


ADR170T (xxxX>mmmmm(yy), ERROR OPENING 
DDNAME ddname 

Explanation: The SYSIN (or acceptable alternative ddname) 
file cannot be opened. 

System Action: The job ends. The return code is 12. 
Programmer Response: Reestablish the SYSIN file, and 
resubmit the job. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADRI71T. ~~ (xxx)}mmmmm(yy), MAXIMUM NUMBER OF 
_ TASKS EXCEEDED 

Explanation: The SYSIN stream contains more than 255 
tasks. 

System Action: The job ends. The return code i is 12. 
Programmer Response: If necessary, run multiple job steps to 
accommodate the number of requested tasks. 

Operator Response: None. | 

Problem Determination: Tabie'l, items 1,3, 4, aky 20, “and 29. 


ADR172T (Xxx}+mmmmm(yy), ERROR DURING INITIAL 
SCAN 

Explanation: During the initial scan of the control statements, 
an error was encountered. 

System Action: The job ends. The return code is 12. 
Programmer Response: Correct the problem as indicated by 
the previous message, and retry the job. , 
Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADRI73T (xxx}+>mmmmm(yy), 1/O ERROR WHILE 
READING ddname, xxxxxxx 

Explanation: . An 1/O error was encountered in’ reading the 
SYSIN file (or acceptable alternative ddname). The ddname is 
followed by the SYNAD information obtained by the 
SYNADAF macro. 

System Action: The job ends. The return code is 12. 
Programmer Response: Correct thé cause of the error or 
reestablish the SYSIN file, and retry the job. 

Operator Response: None. . 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, and 
29. 


ADR174T (xxxX}mmmmm(yy), REMIAINDER OF 
COMMAND INPUT STREAM WAS 
IGNORED 

Explanation: An error occurred that prohibits further scanning 
of the command stream. Messages printed before this message 
indicate the nature of the error. 

System Action: The program ends. The return code is 12. 
The condition code (MAXCC) is always set to 12 when this 
Situation is encountered. 

Programmer Response: Correct the error, and resubmit the 
job. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR175T (XXX}+-mmmmm(yy), COMMAND $xxxxxxxx’ IS 
UNKNOWN 

Explanation: The command name is not recognized. 

System Action: The program ends. The return code is 12. 
Programmer Response: Reissue the command with the correct 
command name. 

Operator Response: None. 


Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADRI176T (xxx}mmmmmj(yy), AN ‘ELSE’ COMMAND IS 
IMPROPERLY PLACED 

Explanation: An ELSE clause appeared in the command 
without a corresponding IF statement. 

System Action: The remainder of the stream is ignored. 
DFDSS processing ends. The return code is 12. 

Programmer Response: Correct the command syntax, and 
resubmit the job. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 
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- Problem Determination: Tabdie I, items I, 3, 4, 13, 20, and 29. 
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ADRI77T (<xx}-mmmmimyy), AN SEND’ COMMAND IS 
; INVALID 
Explanation: An END statement was encountered without a 


matching DO statement. 
System Action: The remainder of the stream is ignored. 

DFDSS processing ends. Message ADR172T follows this 

message. The return code :s °2. 

Programmer Response: Cc-:rect the DO-END sequence, and | 
resubmit the job. 
Operator Response: 
Problem Determination: 


None. 
2ct.e If, items 1, 3,4, 13, 20, and 29. 


ADR178T (Xxx+}mmmmm(yy), AN ‘IF? COMMAND IS 
INVALID 
Explanation: The sequence of the IF-THEN-ELSE statement 
is incorrect. Only the system variables LASTCC and MAXCC 
can be specified, and the va.ces must be decimal numbers from 
0 through 99999. However, a value greater than 16 will be 
reduced to 16. If the variac.e LASTCC is specified, a function 
command must have been creviously encountered in the input 
command stream. 
System Action: The remaincer of the stream is ignored. 
DFDSS processing ends. Message ADR172T follows this 
message. The return codeis 12. | 
Programmer Response: Check the requirements of the 
IF-THEN-ELSE statement sequence, correct the error, then 
reissue the command. 


Operator Response: None. 


ee 


ADR179T (xxx}mmmmmyy), A ‘SET’ COMMAND IS 
INVALID 
Explanation: An invalid SET command was encountered. 


Only the system variables L ASTCC and MAXCC can be 
specified, and the values mus: ve decimai numbers from 0 
througn 99999. However. z -z.ue greater than 16 will b 
reduced to 16. If the variaz.s LASTCC is specified, a aneiee 
command must have been creviously encountered in the input 
command stream. 

System Action: The reme:nczer 
ignored. The return code :s (2. 
Programmer Response: Cre-x the requirements of the SET 
statement, correct the error. :en resubmit the job. 
Operator Response: Nore. | 
Problem Determination: T272:2 I, items !, 3,4, 13, 20, and 29. 


of the command stream Is 


ADR180T = (xxxmmmmmivy), IMPROPER OR MISSING 
‘THEN? 
Explanation: The THEN ¢.s- se of the IF-THEN-ELSE 


command sequence is missinz cor is missoeiled. 

System Action: The rema:nc2r: of the command stream is 
ignored. The return code :s (2. 

Programmer Response: Cov-r22: the error, and reissue the 
command. 
Operator Response: 
Problem Determination: 


None. 


Taz.2 I, items 1, 3, 4, 13, 20, and 29. 


ADRI181T (Xxx}mmmmm+v), TOO MANY LEVELS OF 
‘IF? COMMAND NESTING 
Explanation: More than i0 iF statements were nested, or an 


unended DO group was discc-ered when the command input 
stream ended. 

System Action: The remaince: of the command stream is 

ignored. The return code :s (2. 

Programmer Response: Res::ucture the command stream to 

avoid the excessive nesting anc to end all DO groups, then | 


resubmit the job. 
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_ System Action: 


Operator Response: None. 
Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR182T (xxx}-mmmmm(yy), INPUT STREAM 
END-OF-FILE FOUND BEFORE END OF 
COMMAND 

Explanation: An end-of-file condition was encountered while 


scanning the command. This condition can be caused by 
incorrect command- continuation syntax or by missing records 
in the input stream. 

System Action: The job ends. “The return code is 12. 
Programmer Response: Correct the command syntax, or add 
the missing records, then resubmit the job. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR183I (xxxX>mmmmm(yy), THE REPLACE KEYWORD 
REPLACES THE PURGE KEYWORD FORA 
DATA SET RESTORE 

Explanation: The REPLACE keyword replaces the PURGE 


keyword for a data set RESTORE. 

System Action: Processing continues. 

Programmer Response: None. 

Operator Response: None. | 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR201E (xxx}mmmmm(yy), VTOC IN ERROR PRIOR 
TO PROCESSING 
Explanation: An error occurred in processing the VTOC. The 


. error condition can be caused by one of the following: 


¢ An [/O error occurred. This is usually accompanied by 
system [;O error messages. 


¢ A logical error occurred during indexed VTOC processing. 
When extents are relocated on an indexed volume, a 
recovery environment is set up by DFDSS. If DEFRAG 
ends sefore completing the relocation, the audit trail left by 
the decals: routines indicates to a subsequent DEFRAG 
ageine nm that a mismatch exists between the VTOC index 
corcs and the extents. 


* A fauure occurred during LSPACE(SVC 78) processing. 


* The VTOC structure is incompatible. Message ADR210E 
accomranies this message. More than one of the extents, 
either Gata set or free space, points to the same location on 
the vciume. 


* A prior DEFRAG run or a DADSM function ended 
before updating the VTOC free-space maps. 


The DEFRAG function ends. The return code 
is 8. 

Programmer Response: Do the following when applicable, then 
rerun the DEFRAG function: 


* If 1/O error messages accompany this message, take 
corrective action recommended at your site for the type of 
error. 


* If message ADR210E accompanies this message, recover 
by either deleting one of the overlapping data sets or by 
using AMASPZAP to change the incorrect extent pointer 
to a correct known value, 


* In all other cases, allocate a temporary data set. This 
invokes DADSM modules to rebuild the free-space map or 
to correct the mismatch error. If this procedure does not 
correct the problem on a nonindexed volume, use 
AMASPZAP to turn the DIRF bit off and the DOS bit on 
in the VTOC entry. Then, allocate a temporary data set. 


Operator Response: None. 


Problem Determination: Table I, items 1, 2, 3,4, 13, 14, 20, 


25b, 29, and 35. 


ADR204W = (xxx}}mmmmm(yy), ERROR ENCOUNTERED 
ON EXTENT nnn OF dsname. EXTENT IS 
BYPASSED. 

Explanation: An [/O error occurred in processing an extent of 


the data set for a DEFRAG operation. 

System Action: The extent is not moved. Processing is 
continued with the next data set extent. The return code is 4. 
Programmer Response: Use the PRINT command to print the 
contents of the track or use IEHATLAS to recover the data 
and assign an alternate track. If a system I/O error message 
accompanies this message, take the appropriate action 
recommended at your site for the error. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, and 
29. 


ADR205I (xxx}mmmmm(vy), EXTENT nnn OF DATA 
SET dsname IS ALLOCATED BY CYLINDER, 
BUT IT IS NOT ON A CYLINDER 
BOUNDARY 

Explanation: The VTOC entry indicates that the data set is 
either allocated by cylinder or has the round attribute. 
However, the extent does not begin and/or end on a cylinder 
boundary. 

System Action: DEFRAG attempts to relocate the extent so 
that it begins and ends on a cylinder boundary. If DEFRAG is 
successful, the VTOC entry remains unchanged. If DEFRAG 
is unsuccessful, the extent is relocated as though it were 
originally allocated by tracks, and the VTOC entry is updated 
accordingly. 


If this message is issued Secause the round bit is set, the round 
bit is not turned off. In either case, the message can be 
received on sudsequent DEFRAG operations for the same data 
sel. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: 
29, 


ADR206E = (xxx-}mmmmm(yy), 1/0 ERROR OCCURRED 
WHILE READING VTOC. FUNCTION IS 
TERMINATED 

Explanation: An I/O error occurred in reading the VTOC. 


System Action: The function ends. The return code is 8. 
Programmer Response: Use IEHATLAS to recover the data, 
assign an alternate tracx, and rerun the joo. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3,4, 13, 25a, and 
29, 


ADR207E (xxx}mmmmm(yy), ERROR WHILE SETTING 
DOS BIT IN THE VTOC DURING DEFRAG. 
TASK IS TERMINATED 
Explanation: On a nonincexed VTOC, DEFRAG sets the 
DOS bit on in the VTOC sefore it starts processing and resets 
it at the end. This messaze appears if the setting or resetting 
cannot be done. 

System Action: DEFRAG ends. The return cede is 8. 
Programmer Response: Ir the DOS bit is on, allocate a 
temporary data set on the volume to allow DADSM to rebuild 
the free space information, then scratch the temporary data set. 
Operator Response: None. 

Problem Determination: Table [, items 1, 2, 3,4, 13, 20, 25b, 
and 29. 


-ADR204W — ADR211T~ 





ADR208I (xxx}+-mmmmm(yy), date time BEGINNING 


STATISTICS ON volser: 


FREE CYLINDERS ecce 
FREE TRACKS tttt 
FREE EXTENTS nnnn 
LARGEST FREE EXTENT (CYL,TRK)  ccee,tttt 
FRAGMENTATION INDEX O.fff 
PERCENT FREE SPACE pp 


Explanation: The DEFRAG function issues this message at 
the beginning of the task. This message is also issued when the 
CHECKVTOC keyword is specified for DUMP or COPY. 
The free cylinder value is the number of complete free 
cylinders. The free track value is the number of free tracks in 
addition to free cylinders. The cccc and tttt are the cylinder 
and track values (decimal) respectively. The nnnn indicates the 
number of free extents on the volume, and (cccc,tttt) indicates 
the size of the largest free extent in cylinders and additional 
tracks. The pp is the percentage of free space on the volume. 
The .fff is the fragmentation index. This index can be a value 
between 0.000 and 1.000, for which a higner value indicates a 
higher level of fragmentation. 

System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3,4, 13, 20, and 29. 


ADR2091I (Xxx}mmmmm(yy), MOVED EXTENT nnn 
FROM cezhh-ce:hh TO ce:hh-ce:hh FOR dsname 
Explanation: The nnnth extent of data set dsname was 
successfully relocated from the original cc:hh-cc:hh to a new 
cc:hh-ce:hh, 

System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR210E (xxx+mmmmm(yy), (FREE SPACE jdsname} 
AND {FREE SPACE'dsname} OVERLAP 
FROM CC:HH echh! TO CC:HH echh2 
Explanation: 7 7e indicated data set names and/or FREE 
SPACEs overias on the volume according to the VTOC. The 
VTOC is in error, 

System Action: {[! this message ts issued during DEFRAG 
processing, then the DEFRAG function ends with a return 
code of 8. No extents will be moved by DEFRAG. If this 
message is issued as a result of the CHECKVTOC keyword 
during DUMP or COPY processing, then the continuation of 
the DUMP or COPY processing :s determined by the 
CANCELERROR Keyword specification. 

Programmer Response: Recover cy either deleting one of the 
overlapping data sets or dv using AMASPZAP to change the 
incorrect extent Dointer to a correct value, if known. 

Operator Response: None. 

Problem Determination: Tabie I, items !, 3,4, 13, 20, 25a, and 





ao. 

ADR2111 (xxxX}mmmmm(yy), DATA SET dsname {N USE 
AND WAS NOT MOVED 

Explanation: Another job enqueued or allocated the data set 


while DEFRAG was trying to relocate one of its extents. The 
particular extent was not relocated. 

System Action: Processing continues. 

Programmer Response: None. 

Operator Response: None. 


Problem Determination: Table [, items 1, 3,4, 13, 20, and 29. 
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ADR212I_ — ADR228W 


ADR212I (xxx}mmmmm(yy), EXTENT DISTRIBUTION 


_MAP FOR volser: 


EXTENT *FREE SPACE BEFORE* *FREE SPACE AFTER* ~* ALLOCATED * 
SIZE 
iN NO. oe 40. CUM, NO. CUM. 
TRACKS EXTS PCT (2190 EXTS PCT/100 EXTS PCT/100 
ttt eeee n.ann eeee nh.nnn eeee n.nnn 


Explanation: The distribution map indicates the free-space 
fragmentation before and after the run and the distribution by 
size of data set extents. The map following this message lists 
both the number of FREE SPACE BEFORE extents (eeee) and 
the number of FREE SPACE AFTER extents (eeee) for each 
given size in tracks (ttt), along with the number of 
ALLOCATED extents (eeee). A cumulative percentage of 
allocated extents is aiso provided for each of the three 
categories (n.nnn). 

System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1,3, 4, 13, 20, 25a, and 
29. 


ADR2131 (XxxX>mmmmm(yy), ENDING STATISTICS ON 


volser: - : 


DATA SET EXTENTS RELOCATED nonn 
TRACKS RELOCATED tttt 
FREE CYLINDERS ccce 
FREE TRACKS tttt 
FREE EXTENTS eeee 


LARGEST FREE EXTENT (CYL,TRK) cece, tttt 
FRAGMENTATION INDEX fff 
fe~ = NON-STANDARD 0/5 VOLUME] 


Explanation: This message, printed at the end of the 


extents and tracxs. Message ADR2081 describes the other 
values. An LSPACE SVC obtains the values indicated in 
FREE CYLINDERS. FREE TRACKS, FREE EXTENTS, and 
LARGEST FREE EXTENT. When asterisks (***) appear for 
these values, the tarze. was a nonstandard OS voiume or a 
DOS/VSE volume. 

System Action: None. 

Programmer Response: When asterisks appear in the message, 
verify that the DIRF 5it of the volume is off in the VTOC 
entry. 

Operator Response: None. 

Problem Determination: None. 


ADR220! (XXxX>¥mmmmm(¥¥), INTERVAL BEGINS AT 
CC:HH ce:hh AND ENDS AT CC:HH ce:hh 
Explanation: An 2rea of DASD was selected from which a 


data set extent can te relocated. The interval begins at the first 
ce:hh and ends az :h: 
System Action: No-e. 
Programmer Response: None. 
Operator Response: None. 
Problem Determination: None. 
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ADR221E (xxx}+mmmmm(yy), OVERLAP 
ENCOUNTERED ON EXTENT nnn OF 
dsname 

Explanation: The indicated data set extent overlaps another 
data set extent on the volume according to the VTOC. 
Message ADR2i0E accompanies this message. 

System Action: Processing continues. The return code is 8. 
Programmer Response: Refer to ADR210E. 

Operator Response: None. 

Problem Determination: Table [, items 1,3, 4, 13, 20, 25a, and 
29. 


ADR226W = (xxx+>mmmmm(yy), CCHH RANGE cchhi TO 
echh2 IS UNACCOUNTED FOR IN VTOC. 
Explanation: The indicated cchh range is not described in the 
VTOC. This range will be ignored. 

System Action: Processing continues on the remainder of the 
volume. The return code is 4. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, 25a, and 
29. 


ADR227E (xxx}mmmmm(yy), CVAF ERROR ON 
VOLUME volser, CODE fcee 
Explanation: An error was encountered during a common 


VTOC access facility (CVAF) call for the volume. The fc is the 
CVAF function code, and ec is the CVAF error code. See the 
CVAF Diagnosis Reference for an explanation of the error 
codes. 

System Action: The function ends. The return code is 8. 
Programmer Response: If the CVAF function code-error code 
({fcec) is X'OCO0'," allocate a temporary data set on the volume 
to cause DADSM to repair the VTOC; then rerun the joo. 

For other errors, take the appropriate action recommendec 5v 
CVAF. 

Operator Response: None. 

Problem Determination: If the CVAF function code-error code 
ifeec) is not X'0C00', foliow Table [, items 1, 2, 3, 4, 13, 26, 
Z5a, 29, and 35. 


ADR228W 9 (xxx}mmmmm(yy), INSUFFICIENT FREE 
SPACE OR FREE SPACE 
FRAGMENTATION TO PROCESS DEFRAG 
FUNCTION OR A FREE SPACE EXTENT 
MEETS THE MAXMOVE SPECIFICATION. 
TASK IS TERMINATED 

Explanation: The DEFRAG function determined one of the 

following: 

* The volume was insufficiently fragmented to process the 
function 


¢ There was insufficient free space to process the function 

* There was a free-space extent large enough to meet the 
MAXMOVE specification. 

* If there is fragmented free space on the volume, DEFRAG 
cannot relocate extents with its algorithms or cannot 
relocate them because they are extents which DEFRAG 
does not process (e.g., VVDS, VTOCIX, etc.) to further 
reduce the fragmentation. 

System Action: DEFRAG does not alter the volume. The 
return code is 4. 
Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR229W = (xxx>mmmmnm((yy), VOLUME volser HAS 
TRACKS UNACCOUNTED FOR. THE DOS 
BIT IN THE VTOC WILL REMAIN ON 
FOLLOWING PROCESSING 

Explanation: On a nonindexed VTOC, the DEFRAG function 


encountered uncetined data or free space. This space will not 
be processed. However, the DOS bit will remain on following 
the run. After the DEFRAG run, when the DADSM function 
allocates or scratches a data set on the volume, the free space 
information wis. Se rebuilt, reclaiming the unaccountable space 
as free space. 

System Action: The remainder of the volume is processed. 
The return code !s 4. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table [, items 1, 3, 4, 13, 20, 25a, and 
29. 


ADR2301 (XxXX}mmmmm(yy), MAXMOVE VALUE 
EXCEEDS THE NUMBER OF FREE TRACKS 
ON THE VOLUME. IT HAS BEEN 
ADJUSTED TO THE LOWER VALUE OF 
nnnn TRACKS : 

Explanation: The MAXMOVE value must be less than or 
equal to the pUreer of free tracks on the volume being 
processed. !n tn:s case, the value exceeds the number and is 
adjusted to the i lower value. 

System Action: Processing continues with a MAXMOVE 
value equal to tne number of free tracks on the volume. 
Programmer Response: The MAXMOVE value, if not 
specified, defaults to the total number of free tracks on the 
volume. 

Operator Response: None. 

Problem Determination: Tacie I, items 1, 3, 4, 
29. 


13, 20, 25a, and 


ADR231E (xxX}mmmmm(yy), ERROR WHILE 
ACCESSING VVDS FOR DATA SET dsname 
ON VOLUMIE volser. OP =x, VVDS RC =yyyy 
Explanation: T72 VVDS is accessed for the specified call 
during a DEFRAG, CONVERTY, or data set RESTORE. 


The operation codes (x) can Se: 


0 Insert VVRINVR 

t Geta VV R/NVR for update 

2 Puta VV R NVR for update 

3 Generic r2ad of cormconents of a cluster 
4 Read a \VRINVR. 


The yyyy is the return | 
reason coce uncer return 
Sysiem Messaizs. 
System Action: [7 the operation is DEFRAG, the extent is not 
relocated, If the coeration ‘s data set RESTORE, the affected 
data set is not restored. Otner messages identifying the affected 
data sel accomcany this message. The return code is set to 8. 
Programmer Response: Taxe the appropriate action 
recommended ‘cr the reason codes listed under message 
IDC30091. 

Operator Response: None. 

Problem Determination: See return code 50 in message 
IDC30091 in tre Svstem Messages. Table I, items 1, 2, 3, 4, 
13, 20, and 29. 


-¢ From the VVDS manager. See the 
code 50 in message [DC3009] in 


en ee 


ADR229W — ADR2351_ 





ADR232E (xxx}mmmmm(yy), VVDS DOES NOT MATCH 
VTOC (EXTENTS|DSORG) FOR 
COMPONENT componentname, CLUSTER 
clustername ON VOLUME volser 

Explanation: DEFRAG detected a mismatch between the 


VTOC anc the VVDS. 


EXTENTS: The number or locations of extents for this 
component as reported in the VVDS do not match the number 
or locations of extents reported in the VTOC. A VSAM extend 
operation on the component might have been interrupted 
because of a program or system failure. 


DSORG: DEFRAG detected 2 VVDS entry for a VSAM 
component which is named the same as a VTOC, non-VSAM 
entry. 

System Action: 
code is set to 8. 
Programmer Response: EXTENTS: Run Access Method 
Services DIAGNOSE for the component, and fix the problem 
by using tne procedure recommended in the Access Method 
Services Reference. 


The component is not relocated. Final return 


DSORG: Dump or copy the contents of the offending cluster. 
Then run access method services to delete and recreate the 
offending cluster. Finally, run RESTORE or COPY to replace 
the contents. 
Operator Response: 
Problem Determination: 
29. 


None. 
Table I, items 1, 3, 4, 13, 20, 25a, and 


ADR233W (xxx}mmmmm(yy), ACTUAL 
FRAGMENTATION INDEX IS LESS THAN 


THE REQUESTED VALUE ON VOLUME 


Mai 
Explanation: The volume ‘s not iragmented io ‘ne extent 
indicated in tne user input 
System Action: DEFRAG ends, Tre return code 's 4. 
Programmer Response: None. 
Operator Response: Nore. 





Problem Determination: Tazie [. tems 1, 3,4, :3, 20, ana 2 

ADR234I (XxxX}mmmmm(yv), SEQUENCE 
CCHH1-CCHHI EXTENT DESCRIPTION 

Explanation: This is the messze neader for AD R25. Puls 


message is issued when TYPRUN = SOREN is specified for 
DEFRAG, or when the CHECK VTOC keyword and 
TYPRUN =NORUN are specified for DUMP or COPY. 
System Action: Processing continues. 

Programmer Response: None. 

Operator Response: None. 


Problem Determination: None. 

ADR235I (XXX *¥mmmmm(ss3, anananan cethht cesth? eee 
FREE SPACE -dsname *** UNACCOUNTED 
FOR*** 

Explanation: This is the volume extent mapping message. 


wosaa 
tO eae ec ted 


This message is issued when TYPRUN =NORUN 
for DEFRAG, or when the CHECKVTOC keyword and 
TYPRUN =NORUN are specified for DUMP or COPY. One 
message is issued for each extent on the volume. nannnnnn is 
the relative sequence in which the extent was encountered 

during VTOC analysis, cc:hh! ce:hn2 is the range tne extent 
occupies on the volume, and cee !s the extent number of the 
data set or free space or unaccounted for extent. 

System Action: Processing continues. 


Programmer Response: None. 
Operator Response: None. 
Problem Determination: None. 
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ADR236W — ADR30IE 





ADR236W = (xxx}-mmmmni(yy), VTOC ON VOLUME volser 
DOES NOT CONTAIN A FREE DSCB 
Explanation: The referenced volume does not contain any free 
DSCBs. Because DEFRAG requires a free DSCB for 
processing protected data sets, protected data set relocation 
cannot ce done. 

System Action: Only unprotected data sets are relocated. The 
final return code is 4. 

Programmer Response: If a temporary data set exists on the 
volume, scratch it (to free a DSCB), and rerun the DEFRAG 
job to relocate protected data sets. If a temporary data set 
does not exist on the volume, DUMP a data set, specifying 
DELETE (to free a DSCB), and rerun DEFRAG to process 
protected data sets. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, 25a, and 
29, 


ADR237W ss (xxx}mmmmm(yy), NOT ENOUGH FORMAT-5 
DSCBS AVAILABLE 

Explanation: On a nonindexed VTOC, DEFRAG cannot find 
enough space in the VTOC to rebuild the free space 
information at the end of DEFRAG to reflect the free space on 
the volume. 

System Action: The DOS bit is left on in the VTOC. The 
return code is set to 4. 

Programmer Response: Allocate a temporary data set so 
DADSM can rebuild the Format 5 chain. 
Operator Response:. None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, 25a, 25b, 
and 29. 


ADR2381 (xxx}mmmmm(yy), NO DATA SETS WERE 
MOVED DURING THIS PASS. 
PROCESSING CONTINUES. 

Explanation: No data sets could be moved by DEFRAG. 
This may be due to data sets that are in use, on the link list, or 
extents 100 large for the available free scace area. 

System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR240E (xxx>mmmmm(yy), INSUFFICIENT FREE 
SPACE EXTENTS TO PROCESS DEFRAG 
FUNCTION. TASK IS TERMINATED. 
Explanation: There were less than 2 free space extents on the 
volume. DEFRAG requires at least 2 free space extents to 
process, 

System Action: DEFRAG terminates ::hout altering the 
volume. The return code is 4. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR2411 (Xxxx->mmmmm(yy), TARGET VTOC [INDEX] 
BEGINNING AT ceshh AND ENDING AT ce:hh 
IS {BEING USED | OVERLAID} 

Explanation: Either the target VTOC or index VTOC in the 
indicated cc:hh range is being preserved, or the source VTOC 
location was used for the target VTOC. 

System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 
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ADR242I (xxx}>mmmmni(yy), CHECKVTOC KEYWORD 
IGNORED. NO INPUT VOLUMES 
SPECIFIED 

Explanation: The CHECKVTOC keyword was specified with 
the DUMP or COPY command, but no input volumes were 
specified. No VTOC analysis is performed. 

System Action: Processing continues. 

Programmer Response: Specify an input volume via the 
INDDNAME or INDYNAM keywords. _ 
Operator Response: None. 

Problem Determination: None. 


ADR243W = (xxx}-mmmmnm(yy), VTOC ERRORS FOUND 
ON VOLUME volser. PROCESSING 
CONTINUES 

Explanation: The CHECKVTOC keyword was specified with 
the DUMP or COPY command, and VTOC errors were 
encountered on the specified volume. Because the 
CANCELERROR keyword was not specified, the DUMP or 
COPY operation proceeds. 

System Action: Processing continues. The return code is 4. 
Programmer Response: Refer to the warning and error 
messages preceding this message. 1 at 

Operator Response: None. 

Problem Determination: Refer to the warning and error 
messages preceding this message. 


(xxx}mmmmm/(yy), PROCESSING BYPASSED 

DUE TO CANCELERROR KEYWORD AND 

VTOC ERRORS FOUND ON VOLUME volser 
Explanation: The CHECKVTOC keyword was specified with 


the DUMP or COPY command, and VTOC errors were 
encountered on the specified volume. Because the 
CANCELERROR keyword is specified, the DUMP or COPY 
operation is terminated. 

System Action: Processing terminates. The return code is 8. 
Programmer Response: Refer to the warning and error 
messages preceding this message. 

Operator Response: None. 

Problem Determination: Refer to the warning and error 
messages preceding this message. 


ADR301E (xxx>mmmmm(yy), AN ERROR WAS 
ENCOUNTERED WHILE FILTERING DATA 
SETS ON VOLUME volser. VOLUME WAS 
NOT PROCESSED. 

Explanation: 1/O or logical errors were encountered in 
accessing the VTOC or VVDS on the specified volume during a 
data set DUMP, COPY, or CONVERTY operation. 

System Action: The specified volume is bypassed. Processing 
continues with the next volume, if any. The return code ts 8. 
Programmer Response: For I/O errors, follow your site’s 
recommendations for I/O errors, and resubmit the job. For 
logical errors encountered in the VVDS, run Access Method 
Services DIAGNOSE against the indicated volume and correct 
the problem. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3,4, 5b, 13, 20, 
25b, and 29. If it is a logical error, use the PRINT command 
to print the VTOC and VVDS tracks before taking action 29. 


ADR302E = (xxx}mmmmm(yy), INPUT AND OUTPUT 
DEVICE TYPES DO NOT MATCH. UCB 
TYPE OF INPUT xxxx, OUTPUT xxxx 

Explanation: The source and target volumes of a TRACKS or 


FULL volume COPY or RESTORE are not of like or similar 
device types. 

System Action: The task ends. Processing continues with the 
next control statement. The return code is 8. 

Programmer Response: Probable user error. Select a 
matching device type, correct the control statement in error, 
and rerun the job. If you want to copy to an unlike device, 
specify DATASET on your COPY command. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3,4, 13, and 20. If 
this message occurs when the device types are the same, see 
Table [, items 29 and 35. 


ADR303E (Xxxx}mmmmm(yy), COMMAND NOT 
SUPPORTED WITH SYSTEM RESIDENCE 
VOLUME 

Explanation: A full volume RESTORE or COPY onto, or 


DEFRAG of, the system residence volume is not allowed. The 
system residence volume was specified for output. s 
System Action: The task ends. 
next control statement. The return code is 8. 

Programmer Response: This is a user error. Do not 
RESTORE, COPY onto, or DEFRAG the system residence 
volume. Correct the control statement in error, and rerun the 
job. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3,4, and 13. 
message occurs when the system residence volume was not 
specified as the output volume, see Table I, items 29 and 35. 


ADR304E (xxXX+}mmmmm(yy), ERROR ENCOUNTERED 
WHILE ACCESSING (VTOC!VVDS} IMAGE 
OF VOLUMIE volser ON DDNAME ddname, 
XXXXX 
Explanation: An 2rror (loz:cal or 1.0} was encountered in 
anaiyzing the :mage or tne VTOC or VVDS on tne dumped 
tape during data set RESTORE processing. The types of 
possible logical errors can >e: 

* Anon-VTOC or non-VYDS record 

* An invalid rormat of the VVDS 

* No data on track 

* [/O errors encountered on the track during the DUMP 

* Anend of file during the VTOC or VVDS search. 
If physical 1/O errors were encountered, other [/O error 
messages precece this message. The xxXxx In the message is 
the SYNAD inrermation cassed oy the access wee routines. 
System Action: Tre voiume is byoassed. The return code is 8. 
Programmer Response: Maxe sure the function completed 
normaily during ne DUMP process. If the error is in the 
VVDS, non-VSAM data sets can be restored when you specify 
DSORG NE VSAM in the BY criteria. Use a different backup 
copy to do the RESTORE. 
Operator Response: None. 
Problem Determination: Taole I, items 1, 2, 3, 4, Sb, 13, and 
20. Ifitisa logical error, ist the VVDS and VTOC records on 
the dump tape and take action 29. 


Processing continues with the 


If this . 
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ADR305SE = (xxx mmmmm(yy), UNABLE TO SERIALIZE 
{VTOC|VVDS} ON VOLUME volser 
Explanation: DFDSS failed to get exclusive control of the 


associated DASD volume via enqueuing of the volume’s 
VOLID or VVDS during a 
DUMP/RESTORE/COPY/CONVERTV/DEFRAG operation, 
or a TRACKS or VTOC PRINT operation even after a 
specified or defaulted number of retries. If the resource is 
VTOC, DADSM functions might have been performing while 
DFDSS was trying to serialize the use of the DASD volume. 
{f the rescurce is VVDS, catalog or VSAM functions might 
have been accessing the VVDS. 

System Action: For all operations except DUMP/RESTORE, 
the function ends with a return code of 8. A logical data set 
dump with LOGINDD or LOGINDY specified also ends with 
a return code of 8. Processing continues with the next control 
statement. For a data st DUMP/RESTORE operation 
without LOGINDD or LOGINDY specified, the volume is 
bypassed; a return code of 8 is set, but processing continues on 
any other volumes. 

Programmer Response: Either code 

VOL=(PRIVATE,SER = xxxxxx) in the associated DD 
statement, or request the operator to issue a mount command 
for the volume with the USE= PRIVATE subparameter to 
reduce the possibility of other jobs allocating to (or accessing) 
the volume. Change the WAIT parameters to increase the 
WAIT seconds and the retry count. When system activity on 
the volume is reduced, rerun or resubmit the job. 

Operator Response: Mount the volume with USE= PRIVATE 
before rerunning the job. 

Problem Determination: If no other jobs are running at t the 
time, see Table [, items 1, 2, 3, 4, 5a, 13, 20, 29, and 35. 


ADR306E (xxx}mmmmm(yy), UNABLE TO {COPY | 
RESTORE} THE VOLUMIE BECAUSE 
OUTPUT VOLUME volser IS IN USE. TASK 
IS TERMINATED 

Explanation: A FULL volume COPY or RESTORE was 


attempted on the volume, but another joo is using the volume. 
It is possible that another job is accessing a data set on the 
volume. This message can also be issued during a data set 
COPY when INDD is specified. In this case, the VTOC on the 
volume Was aireacy enqueued. 

System Action: The task ends. The return code is 8. 
Programmer Response: Either code 

VOL=(PRIVATE,SER = xxxxxx) in the associated DD 
statement, or request the operator to issue a mount command 
with the USE=PRIVATE subparameter to reduce the 
possibility of other jobs allocating (or accessing) the volume. 
In the case of data set COPY, remove the INDD keyword and 
rerun the ‘ob. 


For information regarding the DFP “F CATALOG, 
UNALLOCATE?” problem, see the DFDSS User's Guide under 
“Restoring Volumes’, subheading of “Output Volume 
Specification.” 

Operator Response: Mount the volume with USE= PRIVATE 
before rerunning the job. 

Problem Determination: 
time, see Tabie I, ttems 


If no other jobs are running at the 
1, 2, 3, 4, Sa, 13, 20, 29, and 35. 


ADR307E (xxx}mmmmm(yy), UNABLE TO OPEN 
VOLUME volser, xx-yyy 
Explanation: DFDSS is unable to OPEN the indicated volume 


for the indicated reason code (xx). The yyy is the return code 
passed by OBTAIN or RDJFCB. The possible reason codes 
are: 


4 OBTAIN fatlure on VTOC’s VTOC entry. 
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6 The VTOC's VTOC entry is not the first nacéed in the 
VTOC. 


8 RDJFCB failure 
12 OPEN failure. 


See your System-Data Administration book for an explanation 
of the OBTAIN or RDJFCB error return codes. 

System Action: The task ends. Processing continues with the 

next control statement. The return code is 8. 

Programmer Response: If the reason code is 6: DFDSS does 

not support volumes for which the VTOC’s VTOC entry is not 
the first record in the VTOC. 

Operator Response: None. 

Problem Determination: Tabie I, items |, 2,3, 4, 13, and 29. 


ADR308E (xxx}>mmmmm(yy), ACCESS DENIED FOR 
VOLUME volser 
Explanation: One of the following explanations applies: 


* The user was unable to obtain the necessary RACF or 
password access: 


~ To the volume during a data set 
DUMP/COPY/CONVERTV/PRINT/RESTORE 
operation 

— To the volume during a COMPRESS or RELEASE 
operation 

—- To a data set on the volume for 2 full or tracks 
DUMP/RESTORE/COPY/PRINT operation. 


* The installation-wide exit routine denied access to the 
volume. 


* The operator denied access to a checkpoint/restart, 
RACF-protected, or system data set on the volume. 


* I/O errors were encountered during cnecking authorization 
of the volume, and the ocerator dewee further processing. 


System Action: The task ends ona full or tracks operation. 
The volume is bypassed for a cata set oceration or for a 
COMPRESS or RELEASE. The return cede is 8. 
Programmer Response: Obcte:n oroper 2ccesg authority, and 
retry the ‘ob. 

Operator Response: If the orogrammer 72s proper authority, 
reply U to ADR369D or ADR371D. 


Problem Determination: Tacie I, items :, 2, 3, 4, 13, 20, 25b, 
and 29. 
ADR309E (xxx}>mmmmm(yy), SOURCE AND TARGET 


DEVICE CAPACITIES DO NOT MATCH. 
CYLINDER CAPACITY OF SOURCE 
VOLUME xxxx, TARGET VOLUME xxxx 
Explanation: The capacity cr he source vciume is greater than 
that of the target volume. The xxxx is ine nighest cylinder 
number in hexadecimal. 
System Action: The task erncs. Process:nz continues with the 
next control statement. The return code :s 8. 
Programmer Response: Check whether :ne source or target 
volume is: 


¢ An OS/VS-formatted VM /370 minidisx 
* A 3380E (source) and a 3380D (targe:: 
¢ A 3380K (source) and a 3380E or 3380D (target) 


* A 3380E (source) and a 3390-1 (targe: in 3380 
compatibility mode) 


* A 3380K (source) and a 3390-1 or -2 


target in 3380 
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Such conditions are not allowed on a full volume operation, or 
if the range falls outside the capacity of the volume on a tracks 
operation. Select the correct input and output volumes, correct 
the staternent in error, and rerun the job. 

Operator Response: None. 

Problem Determination: Table I, items |, 3,4, 5a, 13, 20, 25b, 


29, and 35. 

ADR310W = (xxxmmmmnm(yy), ERROR FOUND IN VTOC. 
UNALLOCATED SPACE WILL BE 
PROCESSED FOR VOLUME volser 

Explanation: This message is printed for the following reasons: 


¢ A volume without an indexed VTOC indicates no valid free 
space information entries exists in the VTOC. 


* Ona volume without an indexed VTOC, a nonzero return 
code was received from OBTAIN because an I/O error 
occurred, the DSCB was not found, or an invalid work 
area pointer was passed to OBTAIN. 


¢ A nonzero return code was passed by DFP on a volume 
with an indexed VTOC. 


¢ A volume with an indexed VTOC was. accessed on a system 
without DFP installed. 


¢ The DIRF bit is ON; or, on a volume without an indexed 
VTOC, the DOS bit is ON. 

System Action: The entire volume, including unallocated space, 
is dumped or copied. The return code is 4. 
Programmer Response: For an I/O error, take the corrective 
action recommended at your site. If the DOS bit ison for a 
volume without an indexed VTOC, allocate a temporary data 
set to let DADSM rebuild the VTOC entry. 
Operator Response: None. 
Problem Determination: Tabie [, items |, 
and 29. 


2,3, 4, 13, 20, 255, 


ADR311E (xxx}mmmmm(yy), TRACKS OPERATION 
MUST SPECIFY PURGE TO OVERLAY 
{TRACK ZERO | VTOC | VVDS | VTOCIX} 
Explanation: The PURGE parameter was not specified for a 
TRACKS COPY or RESTORE on track 0, the VTOC, the 
VVDS, or the VTOC index data set. 

System Action: The task ends. Processing continues with the 
next control statement. The return code is 8. 

Programmer Response: If you want to overlay any of these, 
specify the PURGE keyword in the command, and rerun the 
job. 

Operator Response: None. 

Problem Determination: Tabie I, items 1, 3,4, 5b, 13, 20, 255, 
and 29. 


ADR312W so (xxx}mmmmm(yy), DURING A TRACKS 
OPERATION, THE VTOC OR TRACK 0 WAS 
OVERLAID 

Explanation: For an attempted TRACKS COPY or 
RESTORE on the VTOC or track 0, the location and extents 
of the VTOC on the source and target volumes did not match. 
System Action: The VTOC or track 0 is overlaid. The COPY 
or RESTORE continues. The return code is 4. 

Programmer Response: Make sure that the overlay was 
intended. If not, restore the output volume from a prior 
backup. 

Operator Response: 
Problem Determination: 
and 29. 


None. 
Table [, items 1, 3,4, 5, 13, 20, 25a, 


ADR313E (xxx}-mmmmm(yy), OPERATOR DENIED 
OVERLAY OF {TRACK ZERO | VTOC | 
VVDS | VTOCIX} ON VOLUME volser 

Explanation: A TRACKS COPY or RESTORE was attempted 


on track 0, VTOC, VVDS, or VTOC index data set. The 
operator was orompted for the necessary authorization, but the 
authorization was denied. 

System Action: The task ends. Processing continues with the 
next control statement. The return code is 8. 

Programmer Response: Rerun the job, and have the operator 
allow the VTOC or tracx 3 to be overlaid. 

Operator Response: If vou have sufficient authority to overlay 
track 0 or VTOC, reply U to message ADR345D. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 14, and 


29. | 
ADR314E (xxx+}mmmmm(yy), ERROR ENCOUNTERED 
WHILE ACCESSING (VTOC|VVDS} ON 
volser. PROCESSING CONTINUES 
Explanation: An I/O error was encountered in dumping the 


VTOC or VVDS of the specified volume. 

System Action: A return code of 8 or 16 is set on the input or 
output error, respectively. Processing continues on input errors 
and ends on outputerrors. If CANCELERROR is specified, 
processing ends on input errors but continues for subsequent 
volumes On a cata set DUNIP. 

Programmer Response: For a data set operation, use . 
IEHATLAS or Device Susport Facilities to recover the bad 
VTOC or VVDS track anc rerun the job. If itis the VVDS, 
follow the procedure recommended at your site for VVDS 
errors (run Access Methcd Services DIAGNOSE and take 
appropriate action). On a cata set DUMP, you can recover 
the logical volumes that were successfully dumped by running a 


numbers inthe LOGICAL. OLUME carameter. 
Operator Response: None. 
Problem Determination: Tacie I, items |, 2, 3, 4, 5, 13, 20, 


25a, and 30. 
ADR3151 (xxXx-mmmmm(yy), REQUIRED CHANNEL 
COMMANDS NOT SUPPORTED ON 
VOLUMIE voalser. OPTIMIZE(1) WILL BE 
USED 
Explanation: Tre device cces not support the Read Multiple 


Count, Key, and Data or Read Track channel commands; or 
I/O errors were encounterec in testing whether the Read 
Multiple Count, Key, anc Data and Read Track channel 
commands are supcorted on the device. OPTIMIZE(2), 
OPTIMIZE(3°, and OPTIMIZE(S\ are applicaodle oniy if one of 
these channel commands :s supported. This can also occur if 
the device can ce accessec 12 muitipie contro! units. Some 
multiple contro: units surcert either channel command and 
others do not. 
System Action: 
function. 
Programmer Response: To zet the performance advantages, 
ensure that all control units attacned to the device support the 
Read Muitiple Count, Key, and Data or Read Track channel 
commands. 

Operator Response: None. 
Problem Determination: Taxsie t, 
29, 


OPTIMIZE :) is used to run the DUMP 


items 1, 2, 3, 4, 13, 20, and 


ggg 
ea ee 
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ADR316W = (xxx}mmmmm(yy), AN {I/O|LOGICAL} 
ERROR WAS ENCOUNTERED ON THE 
{VOLUME LABEL TRACK | VTOC | VVDS | 
DATA TRACKS}, AND ONE OR MORE 
TRACKS WERE NOT PROCESSED 
Explanation: An error occurred on the specified track or 
tracks on the source volume and CANCELERROR was not 
specified. Other messages that precede this message indicate 
the track or tracks that had the error. 

System Action: The tracks that had the errors were not 
processed. [f you are doing a DUMP and the error was on 
VVDS, a data set RESTORE cannot be done for VSAM data 
sets. If the error was on the VTOC, a data set RESTORE 
cannot be done for any data set, but a full or tracks RESTORE 
is possible. If the error was on the volume label track and 
track zero is to be copied or restored, correct the error and 
rerun the job. The return code is 4. 

Programmer Response: If you are doing a DUMP and the 
output is intended for a data set RESTORE, correct the error 
and rerun the job. If it is a logical error on the VVDS, VTOC, 
or volume label track, do a TRACKS PRINT of the VVDS, 
VTOC, or volume label track to check their format. Also, if it 
is the VVDS, run Access Method Services DIAGNOSE on the 
VVDS to determine the nature of the problem. Correct the 
error. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, and 
30. If it is a logical error on the VVDS or VTOC, see Table I, 
items 5b and 35. 


(xxx}mmmmm(yvy), THE DEVICE SIZE FIELD 


ADR3171 
IN THE VTOC IS INCORRECT IF VOLUME 
volser IS NOT A MINIVOLUME. DEVICE 
SIZE OF nanan CYLINDERS WILL BE USED 
Explanation: DFDSS uses the cevice size value passed by the 


operating system's DEVTYP macro. To determine whether 
this is correct, DFDSS does an 1:0 on the volume using the 
high cylinder value. If the 1/O fails (failure can occur if itis a 
VM/370 minivolume) and the cev:ce size field in the VTOC is 
less than the one passed oy DE. TYP, the value in the VTOC 
is used. 

System Action: The device size annn (in hexadecimal) is used. 
Programmer Response: [f it is ~ct a minivolume and the nnnn 
vaiue is incorrect, the DFDSS fsnction completed in error. 
Run AMASPZAP to correct the device size field in the VTOC 
to reflect a full volume, then rerun the job. Ifitis a 
minivolume, action by DFDSS :s correct. Verify that your 
minivolume size equals the size :ndicated in the message. 
Operator Response: None. 


Problem Determination: Tabdie I. :tems 1, 2, 3,4, 13, 20, 255, 

and 29, 

ADR3181 (XxXX+}mmmmm(yy¥), ¥ TRACKS OUT OF x 
WERE DUMPED FROM VOLUME volser 
USING NON-OPTIMIZE CHANNEL 
PROGRAM AFTER ENCOUNTERING 
TRACK OVERFLOW RECORDS 

Explanation: OPTIMIZE chanre! programs fail on tracks that 


have overflow records. An attempt was made to dump x 
tracks using optimize channel program chain. Of these x 
tracks, y tracks were dumped using a nonoptimized channel 
program chain because track overflow records were 
encountered in using optimize channel programs. 

System Action: The y tracks are srocessed using normal 
channel programs. This results :- oerformance degradation. 
Programmer Response: If the number is large, the names of 
data sets not marked as track overflow data sets in the VTOC 
must be specified in the TRACMROVERFLOW keyword if 
OPTIMIZE<2., (3), or (4) is specited. If ALLDATA or 
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ALLEXCP is specitied for a data set, the ailocated tracks 
beyond the end of the used data might have residual track 
overflow records. If so, do not code ALLDATA or ALLEXCP 
for these data sets. 
Operator Response: 
Problem Determination: 


None. 
Table I, items 1, 3, 4, 13, 20, and 29. 


ADR319W = (xxx}mmmmm(yy), VOLUME SERIAL NOT 
CHANGED ON VOLUME volser 
Explanation: An 1/O error was encountered in trying to read 


track 0 from the target volume at the end of the COPY or 
RESTORE. Message ADR348E precedes :his message. The 
rest of the tracks were successfully copied or restored. 
System Action: Processing ends. The return code is 4. 
Programmer Response: The COPY or RESTORE completed 
successfully but the volume serial did not change. Use 
AMASPZAP to update the serial number of the volume, or 
COPY or RESTORE track 0 again. If an alternate track can 
be assigned to track 0, use Device Suppor: Facilities to do so. 
Rerun the job. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, and 


30. 

ADR320I (xxx}+>mmmmm(yy), VOLUME SERIAL xxxxxx 
ON UNIT cuu IS CHANGED TO yyyyyy 

Explanation: The volume ser:ai was changed upon user's 


request. The operator is notified of the change.. 

System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Tabie I, items !. 2,3, 4, 13, 20, and 
29. 


ADR321E (xxXX}mmmmm(*¥), DATA SET dsname NOT 
ON VOLUME volser 

Explanation: The requested cava set is no: on the volume. 
System Action: Processing continues with the next data set. 
The return code ts 8, 

Programmer Response: Correct the data set 
the correct volume, and rerun ine job. 


mame or iccate 


Operator Response: None. 

Problem Determination: Taczie I, items ‘|, 3,4, 13, 20, 25a, and 
29. 

ADR322E (xxx}mmmmm(vy), DATA SET dsname WAS 


NOT SELECTED DUE TO DUPLICATE 
NAME 
Explanation: During a DFDSS DUMP ce: COPY, an attempt 
was made to process one or more data sets with the same 
name. 
System Action: The data se: :s not selectec. The return code is 
8. Processing continues for otner data sets. 
Programmer Response: Recerine the cata set with a unique 
name or select only thal voiume lo process by specifying the 
Input volumes. Rerun the :oz. 
Operator Response: None. 
Problem Determination: Tabie I, items 
29. 


1,3, 4, 13, 20, 25a, and 
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ADR323E (xxx+}mmmmm(yy), ACCESS DENIED FOR 
DATA SET dsname ON VOLUME volser 
Explanation: The user does not have password or RACF 
access to the data set, or the operator denied access to the 
checkpoint/restart or system data set. 

System Action: The PRINT task ends. Processing continues 
with the next control statement. The return code is 8. 
Programmer Response: Acquire authorization to access the 
data set, and rerun the job. |- - : , 
Operator Response: If the user has authorization to access the 
data set, reply U to message ADR369D or ADR371D. 
Problem Determination: Table I, items 1, 3,4, 13, 20, 25b, 29, 





and 35. 

ADR324E —s- (xxx mmmmm(yy), THE VOLUME/DATA SET 
SPECIFIED BY {DDNAME ddname| VOLUME 
volser} HAS BECOME UNUSABLE 

Explanation: A RESTORE, COPY, or DUMP has not 


completed successfully, consequently leaving the output volume 
or data set in questionable condition. For a COPY or 
RESTORE, the volume serial number defines the device that 
has become unusable. For a DUMP, the DD statement 
ddname defines the tape or DASD data set that has become 
unusable as input to the RESTORE. The volume has become 
unusable because DFDSS control information was written to 
the volume yet no valid data sets were copied to it, leaving the 
volume unusabie for any restore copies from that volume. 
Other messages indicating the cause of the error precede this 
message. 

System Action: For RESTORE and COPY, the current task 
ends with a return code of 16, and processing continues with 
the next task. For DUMP, output is halted to the indicated 
ddname but continues for other ddnames, provided the 
installation-wice options exit does not force the cancellation of 
all output ucon the occurrence of a single error. If the 
installation-:ce options exit forces such a cancelation, the task 
ends with a return code of 16, and processing continues with 
the next tasx. 

Programmer Response: If this message is accompanied by I/O 
error messazes, take corrective action recommended in your 
site for such errors and rerun tne job. If the error was on the 
output DASD during a COPY or RESTORE, a rerun might 
fail during authorization checking of the volume. In this case, 
initialize the volume offline to clean the volume before 
rerunning the COPY or RESTORE. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2,3, 4, 13, 20, 25b, 


and 29. 

ADR325E (XXX-}mmmmm(vy}, VOLUME volser HAS 
UNEXPIRED DATA SETS. 

Explanation: A full or tracks COPY or RESTORE tried to 


overlay uneXxcired data sets. 

System Action: The task ends. Processing continues with the 
next controi statement. The return code is 8. 

Programmer Response: If overlay is intended, specify the 
PURGE oot:on, and rerun the job. 

Operator Response: None. 

Problem Determination: Table [, items 1, 3, 4, 13, 20, 255, and 
29. 


ADR327W = (xxx}-mmmmm(yy), NO DATA SETS 
PROCESSED FROM {VOLUME 
volser|LOGICAL VOLUME volser} 


Explanation: One of the following applies: 


¢ A data set DUMP, COPY, CONVERTV, or RESTORE 
did not seiect any data sets that matched the filtering 
criteria. 


* The selected data sets cannot be processed because of. 
failure to ENQ or to allocate. 


* The selected data sets cannot be processed because of 
failure to access the protected data sets. 


¢ For a RELEASE, no data sets were selected because none 
have releasable space. 


System Action: Processing continues on the next volume. The 
return code is 4. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, 25b, and 
29. 


ADR328E (xxx}mmmmm(yy), ERROR DURING DATA 
SET SELECTION. VOLUME volser IS 
BYPASSED 

Explanation: A data set DUMP, COPY, CONVERTYV, or 
RESTORE with filtering failed on the indicated volume during 
VTOC or VVDS processing. For a RESTORE, the volser is © 
the volume serial of the source volume. 

System Action: Processing continues on the next source 
volume. The return code is 8. 

Programmer Response: Determine the failure from the 
previous messages associated with this taskid. 

Operator Response: None. 

Problem Determination: Table I, items !, 2,3, 4, 13, 20, and 
29. 


ADR329I (xxx}mmmmm(yy), DATA SET DUMP OF 
VOLUME volser {BEGINS|ENDS} ON TAPE 
serial SEQUENCE seq 

Explanation: A data set DUMP for the indicated volume 
started or ended on the svecified tape and on the specified data 
sequence number. 

System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2,3, 4, 13, 20, and 
29. 


ADR330W 9 (XxxXx}mmmmm(yy), OLTPUT VOLUME volser 
IN USE. PROCESSING CONTINUED 
Explanation: Tne output volume was in use by other jobs in 
the system during a tracks COPY or RESTORE. Some of the 
data sets mapped dy these tracks might nave been in use while 
DFDSS was processing the volume. 

System Action: The tracks operation is continued. If the data 
sets mapped by these tracks were in use, the contents of these 
tracks are unpredictable. The return code is set to 4. 
Programmer Response: Analyze the job log to check if the 
dala sets mapped oy the tracks were in use at the time of the 
COPY or RESTORE. If they were, rerun the COPY or 
RESTORE if necessary. For information regarding the DFP 
“F CATALOG, UNALLOCATE?” problem, see the DFDSS 
User's Guide under “Restoring Volumes”, subheading of 
“Output Volume Specification.” 

Operator Response: None. 

Problem Determination: Table [, items 1, 2, 3, 4, 13, 20, 29, 
and 35. Display the contents of the UCB when this job is 
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running to check on the number of data sets allocated or 
opened to this device. 


ADR331E (xxx}>mmmmnm(yy), OUTPUT BLKSIZE yyyyy 
FOR DATA SET ON DDNAME ddname IS 
SMALLER THAN INPUT BLKSIZE 2222z 
Explanation: The block size specified in the JCL (or, if not 
specified, the defaulted block size) for output on DASD is 
smaller than the block size of the input volume created during 
the DUMP. This is not allowed. The yyyyy and 22z2z are in 
decimal notation. 

System Action: The task ends. Processing continues with the 
next control statement. The return code is 8. 

Programmer Response: Do not specify block size in the JCL, 
or, if a DASD data set is required, use a DASD that allows a 
larger block size. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, and 
29. The first record on the dump tape contains the input block 
size. 


ADR333W = (xxx+}mmmmm(yy), DATA SET CHANGE 
INDICATOR NOT RESET FOR 
{dsname|ciustername componentname} ON volser, 
{I/O ERROR|OBTAIN ERROR|NOT ENQ BY 
DFDSS, rc} 

Explanation: In the VTOC on the indicated volume, the data 
set change indicator cannot be reset in the data set’s VTOC 
entry. Either DADSM OBTAIN failed, an I/O error occurred 
while writing the data set VTOC entry, or the data set was not 
enqueued by DFDSS. rc is the error code passed by the 
OBTAIN macro. 

System Action: The data set change indicator was not reset for 
the data set. The return code is 4. 

Programmer Response: Either rerun the job, or use 
AMASPZAP to reset the indicator. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, and 
29. 


ADR335W ) (xxx}mmmmm(yy), DATA SET CHANGE 
INDICATOR NOT RESET FOR ANY DATA 
SET ON A VTOC TRACK ON VOLUME 
volser 

Explanation: An input I/O error was encountered on a VTOC 
track when the data set change indicator was being reset in the 
VTOC entries. 

System Action: The data set change indicator is not reset in 
any of the VTOC entries on the track. The return code is 4. 
Programmer Response: Wait until the next run to reset the 
change indicator, or run IEHLIST to list the VTOC and use 
AMASPZAP to reset the VTOC entries. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3,4, 13, 20, 25b, 
and 29. 


ADR3361 (xxx*¥mmmmno(yy), LOGICAL ERROR WHILE 
READING VOLUME volser, TRACK cchh, 
CCW opcode 

Explanation: An unexpected error was encountered during a 
read operation that used the Read Multiple Count, Key, and 
Data or Read Track channel command. Normally, you need 
not take any action; however, see “Programmer Response”. 
System Action: The track is reread using other channel 
commands. 

Programmer Response: If you get this message too many 
times in a job, then either the DASD ERP program that retries 
a temporary data check or DFDSS might be in error. 
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Yneratar Dacnanca: 
VPeracor meSPponse: 


i¢ 
Problem 


Niane 
mone. 


Determination: Table I, items 35, 5, and 29. 





ADR338W = (xxx}}mmmmm(yy), DATA SET CHANGE 
INDICATOR NOT RESET FOR ANY DATA 
SET ON VOLUME volser 

Explanation: DiDSS was -nable to acquire exclusive access of 
the VTOC on the specified volume for resetting the data set 
change indicator in the VTOC entries. 

System Action: The data set change indicator is not reset for 
any data set on the volume. The return code is 4, 

Operator Response: None. 

Problem Determination: T2>:e I, items 
29. 


1,2, 3,4, 13, 20, and 


ADR339W  (xxx}mmmmm(vy), 1/0 ERRORS WERE 
ENCOUNTERED ON THE FOLLOWING 
DATA SETS DURING PROCESSING FROM 
volser 

Explanation: A data set DUMP or COPY was specified, but 
one or more data sets encountered I/O errors. The list of data 
sets following this message indicates which data sets did not 
dump or copy successfully cecause of I/O errors. 

System Action: If DELETE or RESET options were indicated 
in the control statements, the data sets indicated in the list are 
not deleted and the data set change indicator is not reset. The 
return code is 4, 

Programmer Response: If a RESTORE is attempted for these 
data sets, the tracks that had the error are not restorable and 
will be cieared. 
Operator Response: 
Problem Determination: 


~ None. 
Tadle I, items 1, 2, 3, 4, 13, 20, and 


30. 

ADRASUE (xxx+mmmmmityv), OUTPUT 1/0 ERROR 
ENCOUNTERED ON VOLUME volser 
DURING RESET OF THE DATA SET 
CHANGE INDICATOR IN THE VTOC 

Explanation: A termianeni 7Ltout error was encountered on 

“he InDul Yaiuime “wrile ine lita set change indicator was being 

Ose. lucimg a fu DUMP. Tne output from the DUMP is still 

48actic. An i,O error messaze2 indicating the nature of the error 





System Action: 
statement. The return code is 8. 

Programmer Response: [: ine I/O error message indicates that 
the volume is usadie, take ine same action as in message 
ADRSS3 W; vise, resicre the volume. 

Operator Response: Nore 
Problem Dete rmination: Tar.2[, items t, 2,3, 4, 13, 20, 2Sa, 


ay 2 


ALR 342i ‘vatemmmmmivy), DATA SET CHANGE 
INOICATOR HAS BEEN RESET FOR ALL 
QUALIFIED DATA SETS ON VOLUME 
voiser 

Explanation: ai WTC eniries that nad the indicator on, 

the data set change indicator was reset during a full volume 

DUMP. 

System Action: None. 

Programmer Response: Nore. 

Operator Response: Nore. 

Problem Determination: Tacie I, items 1, 2,3, 4, 13, 20, and 

30 


for 
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ADR343E = (xxx}mmmmm(yy), VTOC IS FULL ON THE 
SINGLE TARGET VOLUME. NO MORE 
DATA SETS WILL BE PROCESSED. 

Explanation: DFDSS cannot continue to allocate data sets on 


the volume specified by the user because its VTOC is full. 
System Action: The job ends. The return code is 8. 
Programmer Response: Use ICKDSF or a similar product to 
expand the VTOC of the target volume, and rerun the job or 
specify additional target volumes. _ a 4 
Operator Response: 
Problem Determination: 


None. 
Table I, items 1, 3, 4, 13, and 29. 





ADR344I1 (xXxx>mmmmm(yy), VOLSER ON UCB cuu IS A 
DUPLICATE. VOLUME MADE 
UNAVAILABLE. 

Explanation: A RESTORE or COPY resulted in a duplicate 


volume serial number in the UCB. 

System Action: The volume on the specified UCB is made 
unavailable to the system. Message ADR320I precedes this 
message. . 
Programmer Response: None. 

Operator Response: To make the new volume available to the 
system, the old volume with this volume serial must be 


- unloaded or varied offline before the mew volume is made ~ 


available to the system. 
Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, and 


29. 

ADR345D (Xxx}mmmmm(yy), REQUEST 
AUTHORIZATION TO OVERLAY {TRACK 
ZERO | VTOC | VTOC INDEX | VVDS} ON 
UCB cuu, jobname, stepname, procname. REPLY 
U ORT 

Explanation: A TRACKS COPY or RESTORE is being 


attempted om 2 sortion of the VTOC or on track zero. 
System Action: Processing continues according to the 
operator’s response. The return code is 0. 

Programmer Response: Instruct the operator to let DFDSS 
continue processing, and rerun the joo. 

Operator repens: A response of R 22. U allows DFDSS to 
overlay tracx 0 or tne VTOC. A response of R 2z, T ends the 
operation, and processing continues with the next function. 


Problem Determination: Tabie I, items 1, 2,3,4, 13,20, and 
29. 
ADR346! (Xxx!mmmmm(yy), VTOC INDEX WILL BE 


DISABLED ON VOLUME volser 
Explanation: The installation-wide exit requested that the 
VTOC index not be reconstructed. 
System Action: The DFDSS function continues processing. 
The SYS:.VTOCIX.volser data set is not reconstructed by 
ICKDSF. 
Programmer Response: The [CK DSF program can be 
performed secarately from DFDSS. 
Operator Response: None. 
Problem Determination: None. 


ADR347E (xxx-mmmmm(yy), PERMANENT I/O ERROR 
ON DDNAME ddname,xxxxxxxxxxxx 
Explanation: A permanent I/O error occurred on the indicated 


DD statement. The ddname is followed by the SYNAD 
information passed by EXCP. 

System Action: A DUMP ends with a return code of 16. 
Continuation of a RESTORE depends on the 
CANCELERROR option coded by the user. If 
CANCELERROR is coded, the RESTORE ends with a return 
code of 16; otherwise, recovery is attempted but results are 


unpredictable. Processing continues with the next input control 
statement if a return code of 16 is set. 

Programmer Response: For a DUMP, take appropriate 
corrective action, and rerun the job. For a RESTORE, use a 
different version of the backup copy. 

Operator Response: None. 

Problem Determination: Table I, items i}, 2,3,4,5, 13,20, and 


30. 

ADR348E (xxx}mmmmm(yy), PERMANENT 
{INPUT|OUTPUT} ERROR ON VOLUME 
volser cchh opcode csw sense 

Explanation: The DASD device con:ained a permanent I/O 


error. The cchh, opcode, csw, and sense are printed in 
hexadecimal digits. 

System Action: Another message exc:aining the ending action, 
if any, follows this message. The return code is 8. 

Programmer Response: Take approcviate action recommended 
at your site for the error identified by :he sense information in 
the message. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2,3, 4, 13, 20, and 
30. 


ADR349W = (xxx+}mmmmm(yy), ERROR ENCOUNTERED 


WHILE REBUILDING F5-DSCB ON 
VOLUMIE voiser 
Explanation: An error occurred when a temporary DFDSS 
data set, && DFDSS.TEMPDS.volser. was to be allocated. 
System Action: The DOS converted VTOC bit for the 
indicated volume is set on. The free space information should 
be accurate. The return code is 4. 
Programmer Response: Use the IEHLIST utility program to 
determine the VTOC accuracy. If there were other DFDSS or 
allocation error messages, you migh. n2ed to perform the 
COPY cr RESTORE !o05 azain. 
Operator Response: None. 


Problem Determination: Taoie I, items :, 2, 3,4, 13, and 25b. 


ADR350E (<Xx¥mmmmm(yy), {1.O LOGICAL ERROR} 
ENCOUNTERED ON VVDSjVVDS IMAGE} 
ON volser 

Explanation: One of the Tollowing ac7..es: 


« J/O errors were encountered wh:iz ine VVDS tracks were 
being read. 


* Logical errors were encountered #rtle the VVDS was being 
scanned for authorization checkinz on a TRACKS or 
FULL vo.ume operation. 


* Logical errors were emcounterec “rie data sets were ceing 
seiected during a data se: DUMP >- RESTORE. 
System Action: [f this error occurs iuring a FULL volume or 
TRACKS operaucon while cnecking @-tnorization, other 
messages accompany this message. i! inis error occurs Curing 


data set selection, tne volume is bypassed. The return coce is 
8. 
Programmer Response: 


* Por a logical error during DUMP: Run Access Method 
Services DIAGNOSE on the volume to determine the 
probiem, anc correct it Sy using ine orocedure 
recommended by the decess Meinca Services Reference. 

* For a logical or physica! error during RESTORE: Usea 
previous bacxup copy to restore xe desired VSAM data 
set. 
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¢ For a physical I/O error during DUMP: Take the 
appropriate action recommended in your site, or contact 
your system programmer. 


Operator Response: None. 
Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, and 
29, 


ADR351E- (xxx}mmmmm(yy), UNEXPECTED END OF 
FILE ON DDNAME ddname 

Explanation: An unexpected end of file was encountered before 
the normal end of processing. The input used might have been 
created in a DUMP that abnormally ended. 

System Action: The task ends. The output volume or data 
sets may be unusable. Processing continues with the next 
control statement. The return code is 8 or 16. 

Programmer Response: Use a good copy of the backup, and 
rerun the job. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, and 
29; 


ADR352W ss (xxx}+}mmmmm(yy), VOLID ON UNIT cuu, 
THAT HAD VSAM DATA SETS, HAS BEEN . 
CHANGED FROM volser! TO volser2 
DURING A TRACKS OPERATION 
Explanation: The output volume contains VSAM data sets. 
The VOLID was changed on the volume. If the tracks 
mapping these data sets were not copied or restored, these data 
sets might be inaccessible because of the change in the VOLID. 
System Action: The VOLID was changed. The return code is 
4. 

Programmer Response: If the data sets are inaccessible, reset 
the VOLID to the original value. 

Operator Response: None. 

Problem Determination: Tabie [, items 1, 2, 3,4, : 
29. 


ADR3S53I (Xxx>mmmmm(yy), THE FOLLOWING DATA 
SETS WERE SELECTED FROM VOLUME 
volser 

Explanation: TYPRUN=NORUN was specified in the EXEC 
statement parameter, and in data sets, the list of names that 
follows this message met the filtering criteria on the volume. 
System Action: The data sets are not processed. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, 25b, 
and 29. 


ADR354W ) (xxx>mmmmm(yy), ERRORS ENCOUNTERED 
WHILE PROCESSING {VVDSiVTOC} ON 
VOLUME volser 

Explanation: Errors were encountered while the VV DS or 
VTOC were being processed. 

System Action: If the error is on the VTOC, you cannot do a 
data set RESTORE on VSAM data sets. Only ruil or tracks 
RESTORE can be done from the DUMP output. The return 
code is 4. 

Programmer Response: Other error messages accompany this 
message. If you want to do a data set RESTORE from the 
DUMP output, take the appropriate action and rerun the job. 
Operator Response: None. 

Problem Determination: Table [, items 1, 2, 3,4, 13, 20, and 
29. 
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ADR35SW ss (xxx mmmmm(yy), CHANGE VOLID ON 
UNIT cuu FROM volsri TO volsr2 

Explanation: A full COPY or RESTORE onto the volume was 
done from the source volume without specifying 
COPYVOLID. The VVDS data set name in the VTOC and 
the volume seria: or the VVR for the VVYDS on the output 
volume were carried over from the input volume. This does 
not agree with the volume serial of the output volume. 

System Action: The VSAM data sets on the receiving volume 
cannot be accessed untii the volume serial of the receiving 
volume is changed. The return code is 4. 

Programmer Response: If you want to access VSAM data sets, 
use Device Support Facilities to change the volume serial of the 
receiving volume. Do not rerun the COPY or RESTORE job 
until the volume serial is changed because authorization checks 
may fail. 

Operator Response: 
Problem Determination: 
29: 


None. 
Table I, items !, 2, 3, 13, 20, 25b, and 


ADR356E (xxx}mmmmm(yy), TASK TERMINATED BY 
UIM EXIT (nn) 

Explanation: The indicated User Interaction Module exit point, 
nn, ended the related DFDSS function before normal 
completion. 

System Action: The return code is 8. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items i, 3, 5, 13, 20, 29, and 






35. 

ADR357W ss (xxx}-mmmmm(yy), PROCESSING VSAM 
DATA SETS CATALOGED IN THE 
INTEGRATED CATALOG FACILITY IS NOT 
SUPPORTED UNDER THIS OPERATING 
SYSTEM. 

Explanation: The input volume contained VSAM data sets 

cataloged in the [ntegrated Catalog Fac.ity Catalog, or a 

request {specific or implied) to process these data sets was 


made. Such precessing !s not supportec sy DFDSS under this 
operating system. You can process these cata sets only in the 
MVS/370 or MVS XA Data Facility Product environment with 
the REALLOC Macro Support installec. 

System Action: Ir requested, non-VSAM data sets are 
processed. The return cade its 4. 

Programmer Response: If non-VSAM data set processing is 
desired, but not recuested, rerun the jod requesting only 
non-VSAM data set orocessing. 

Operator Response: None. 

Problem Determination: [f the system :s running in the 
DFP/370 or DFP XA with REALLOC Macro Support 

13, 20, 29, anc 35. 


Table [, items 1. 2.3, 4, 5, 





ADR358W ) (xxx}¥mmmmm(yy), PROPER LEVEL levelnum 
OF productname NOT ON THE SYSTEM. 
{COMMAND | VOLUME volser | DATA SET 
dsname} WILL BE PROCESSED, re. 
Explanation: The oroper level of the named licensed product ts 


not installed. ‘The reason code, rc, indicates: 
1 VSAM linear data set support requires MVS/XA Data 


Facility Product Version 2 Release 3.0. The target data set 
is allocated as ESDS. 


nm 


Locked user catalog support requires MVS/XA Data 
Facility Product Version 2 Release 3.0. The LOCK status 
of the user catalog is ignored. 
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3 VSAM VRRDS data set support requires MVS/XA Data 
Facility Product Version 3 Release 3.0. The target data set 
is allocated as KSDS. 


System Action: Processing continues. The return code is 4. 
Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, and 
29. 


ADR359W ss (xxx¥mmmmm(yy), UTILITY PROCESSING 
FOR DATA SET dsname COMPLETED WITH 
WARNINGS. 

Explanation: The utility successfully processed the data set but 


issued warning messages during processing. These messages 
are not spooled to SYSPRINT unless the DFDSS parameter 
UTILMSG = YES is specified. 

System Action: Processing continues for other data sets. 
Return code is 4. 

Programmer Response: Specify DFDSS parameter 
UTILMSG = YES, and rerun the job to view utility messages. 
Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3,4, and 13. 
ADR3601 (xxx+}mmmmm(yy), PROCESSING LOCKED 
USER CATALOG catname 

Explanation: The corresponding VVR for the integrated 
catalog facility user catalog being processed had the lock 
indicator set on. 

System Action: The function continues processing. 
Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR361E (XxXxX}mmmmm(yvy), REQUIRED LEVEL 
levelnum OF productname IS NOT ON 
SYSTEM. {FUNCTION/|VOLUME 
volser;DATA SET dsname|KEYWORD 
keywordname} NOT PROCESSED, re. 
Explanation: The indicated level of a system product is not 
installed, but it is required to process the particular DFDSS 
function, volume, or data set. The reason codes are: 


1 CONVERT keyword with PDSE subkeyword requires 
MVS/DFP Version 3 Release 2 and MVS/SP Version 3 
Release 1.0E. 

3 SMS function keyword requires MVS DFP Version 3 
Release 1. 


System Action: The return code is 8. The functionjvolumejdata 
set. keyword ts not processed. 

Programmer Response: Verify that the indicated level of the 
system product is instailed and rerun the job. 

Operator Response: None. 
Probiem Determination: Table I, items 1, 3,4, 13, 20, 25a, 25b, 
and 29. 


ADR362T (xxx+mmmmm(yy), NO BUFFER AVAILABLE 
& NONE IN WRITE 
Explanation: The DFDSS I/O modules cannot find a free 
buffer. There are outstanding requests for waits or checks. 
System Action: The job ends. The return code is 12. 
Programmer Response: Contact IBM for programming 
support. 

Operator Response: 
Problem Determination: 


None. 
Table I, items 1, 2, 3,4, 5, 13, and 29. 


ADR363E (xxx+}mmmmm(yy), SOURCE DATA SET 
dsname {IS EMPTY | HAS AN 
UNSUPPORTED DSORG}. IT WILL NOT 
BE COPIED TO PREALLOCATED TARGET 
DATA SET. 

Explanation: The data set will not be copied to the 
preallocated target data set for one of the following reasons: 


¢ Itis empty. 


* It has a BLKSIZE of 0 and the target volume is of unlike 
device. 


* It has an unsupported DSORG and the target voiume is of 
unlike device. 


System Action: The data set was not copied. Processing 
continues, The return code ts 8. 

Programmer Response: To have the data set copied, do one of 
the following: 


* For an empty data set, use ALLDATA or ALLEXCP to 
force copy of all allocated space in the data set. Make sure 
that the selected target volume is of like device and that the 
data set is not being reblocked. 


¢ For a data set with a BLKSIZE = 0, make sure that the 
selected target volume is of like device. 


* For a data set with an unsupcorted DSORG, make sure 
that the target volume is of like device. For a data set with 
an unsupported DSORG going to an unlike target device, 
specify the PROCESS keyword with the UNDEFINED 
subkeyword. The specified or chosen target device must 
have a track capacity equal to or greater than the source. 


None. 
Table 


.aV 


Operator Response: 


Problem Determination: T items 1,3, 4, 13, 20, and 29. 


ADR364W  (xxx+>mmmmm(yy), TRACK CANNOT BE 
RESTORED DUE TO DATA CHECK 
DURING DUMP. CCHH cchh, DDNAME 
ddname 
Expianation: An error «as encountered on a DASD volume 
Guring the DUMP. Because CANCELERROR was not coded, 
a dummy record was dumzed. This record is recognized during 
the RESTORE. 

System Action: The ind:cated track is not restored. Processing 
continues for other tracxs. The return code is 4. 

Programmer Response: Use I[EHATLAS to re-create the data. 
Operator Response: Nore. 


Problem Determination: T22le I, items 1, 2, 3,4, 13, 20, and 
29, 
ADR365E (XXX ¥mMmmmmyy), THE CATALOG catname 


SPECIFIED IN {RECATALOG ; INCAT} IS 


NOT AVAILABLE. THE (COPY ' DUVIP | 
RESTORE CONVERTY} TASK IS 
TERMINATED. 
Explanation: The cataiog scecified in the RECATALOG or 
INCAT parameter does not exist or is mot avaiaole on the 
system. 
System Action: Performarce of the task ends. The return 
code is 8. 


rc 


Programmer Response: Ensure that the catalog name is 


correct and avatiaole, anc -e run the job. 
Operator Response: None. 
Problem Determination: Tadie [, ite , 3,4, 13, 20, and 29. 
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ADR366W = (xxxmmmmm(yy), TRACK cchh WRITTEN TO 
VOLUME volser WITH INVALID TRACK 
FORMAT 

Explanation: The track identified by the cchh had invalid track 
format on the source volume during DUMP or COPY. It was 
restcred or copied with the same condition to the indicated 
target volume. When this track is accessed on the target 
volume, the invalid-track-format condition will recur. Or, a 
BDAM data set that could not be accessed by relative block 
address (that is, it had a standard user label or its record 
format was not fixed or fixed block) was being copied from a 
smailler-capacity DASD to a larger-capacity DASD. A track 
of data from the smaller-capacity device could not fit on the 
track of the larger-capacity device. This condition can occur 
when the data set without fixed or fixed-block record format 
has a large maximum blocksize but the actual blocks are so 
small that the track of the larger-capacity device cannot contain 
all the smaller blocks because of the increased inner-block gap 
size of the larger-capacity device. ADR366W is issued for each 
track copied that will not fit on the track of the larger-capacity 
device, and the copy will continue. (You can stop the copying 
of such data sets by using the CANCELERROR keyword. 
Refer to the use of CANCELERROR in the DFDSS Reference 
and in Message ADR367E in this manual.) 

System Action: Operation continues and the remaining tracks, 
if any, are restored. The return code is 4. 

Programmer Response: None. 

Operator Response: None. 


Problem Determination: Table I, items 1, 2, 3, 4, 13, and 29. 


ADR367E (xxx}mmmmm(yy), {RO COUNT 
FIELDJINVALID TRACK FORMAT} ERROR 
ON UUNPUTIOUTPUT! VOLUME volser cchh 
opcode csw sense 

Explanation: ener the ochh wacx had an invalid track 
format, or a searen [D for RO on this track failed, 

System Acton: if the RO count fieid error is encountered on 
an input volume and CANCELERROR was specified. the 


Lo. obnerwise, processing 








If the invaud-track-format condition was ereo un ete: all the 
Piss ack is written to 

“i yeitume (COPY and DUMPS, eee he track is 

S having an invalid-track-format condition on the 


Wit SPO AES PERE SOAs tars % 








output tape (DUMP only). In this case, the return code is set 
t ig Also, this message is issued in stead of ADR366W when 
copying BDAM data sets when an invalid-tr ack: formal error 
occurs ON 4 Write LO an output volume x the | ee auos 
Cc hed, e COPY of the data 
or is stopped, and the 
oneurrent oe 
of th many as three invalid 
wack of tne data set can be 
ended : 3o7 ik messa; might ce issued oefore 
the copy can be ended). The COPY sop ail continue ¢ 
process any subsequent data sets. 
Programmer Response: if the function ends because of the RO 
count field error, correct the RO record pucine Device Support 


Facilities and rerun the job. For an invalid-track-format 


condition, the user needs to reconstruct the track in error after 
the RESTORE. . 

If CANCELERROR has been Te the invalid track 
format track is erased ffom the target and the target data set is 
deleted during COPY or RESTORE, processing. 

Operator Response: Mone. 

Problem Determination: Table [, items |, 2, 3,4, 13, 20, and 


25. 
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ADR368E — ADR373E 


Sete oF eee te 





ADR368E = (xxx}mmmmm(yy), 1/0 ERROR ON DDNAME 
ddname WHILE {PROCESSING 
VTOC|ADVANCING TO NEXT TRAILER 
RECORD} xxxxxx 

Explanation: An I/O error was encountered in processing the 


VTOC or in bypassing the file for a data se. RESTORE. The 


XXXXXX is the SYNAD information passed by the access | 


method routines. 

System Action: If the operation was to process the VTOC, the 
restore ends and no further processing is performed. If the 
operation was to advance to the next traiier record, the restore 
continues because the I/O error occurred on a record that was 
not needed for this restore. The return code is 8. 

Programmer Response: If the operation was to process the 
VTOC, use a different version of the backup copy. If the 
operation was to advance to the next trailer record, permanent 
errors will result if a future RESTORE is attempted to restore 
the record tnat had the I/O error. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2,3, 4, 13, 20, and 
30. 


ADR369D —s- (xxx mmmmmn(yy), AUTHORIZE FOR 
{READ|WRITE} ACCESS {A 
CHECKPOINT/RESTART DATA SETIA 
RACF DATA SET ON NON-RACF 
SYSTEM|A VVDS| A VTOCIX|ICF VSAM 
DATA SET ON NON-ICF SYSTEM} ON 
volser,jobname,stepname, REPLY U OR T 
Explanation: The requested authorization is for: 

* A checkpoint/restart data set 

* A RACE data set on a non-RACF system 

* A VVDS or VTOCIX data set 

* An intezrated catalog facility-cataiogec VSAM data set on 

a MOAN Sprated cataicg rach ity system. 

System Action: Processing continues acccrcing to the 
operation action. [f the operator replies 7, a full or tracks 
operation ends and, on a data set operation. the data set is not 





processec. The return code is 3. A repiv cf U authorizes the 

dala set ic De processed. 

Programmer Response: Instruct the operaicr to authorize the 
v 


processing via a recly of U, and rerun the :od. 

Operator Response: Respond & 22,U to cause DFDSS to 

continue crocessing the data set or volume. Respond R 22,T to 

end the function and cause processing to continue for the next 

data set or next control statement. 

Problem Determination: Tabie I, items 1, 2.3, 4, 13, 20, and | 
29. 


ADR370E — (xxx}mmmmm(yy), INVALID SEQUENCE | 


NUMBER ON DDNAMIE ddname LAST | 


Explanation: During a RESTORE, ne secuence number of 

the recore read (2222Z22z in nexadec:ma:: ¢:d not match the 
previous record processed (yyyyyyyy in hexadecimal). If there 

is an enc of volume involved, 2 tape migh: nave been mounted | 
in the wrong sequence. | 
System Action: Processing continues with tne next control 
statement. If the output volume was upca:ed, a return code of 

16 is set, otherwise, a return code of 8 is sez. | 
Programmer Response: Probaole user error. Mount the 

proper restore tape, or use the correct dums data set. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3,4, 13, and 28. If 

tapes were not involved or tapes were mounted in the right 
sequence, take actions 5b, 29, and 35. 
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ADR371D = (xxx}}mmmmnj(yy), 1/0 ERROR ON volser 
DURING AUTH CHECKING FOR 
{INPUT|OUTPUT} ACCESS, jobname, 
stepname, REPLY U OR T 

Explanation: An I/O error was encountered while the VTOC 
was accessed for authorization checking. 

System Action: Processing continues, depending on the 
response from the operator. A reply of T ends the function 
with a return code of 8. . 
Programmer Response: Instruct the operator to let DFDSS 
continue processing, and rerun the job. 

Operator Response: If the user has authorization to access the 
volume, reply & zz,U to continue the function. Otherwise, 
reply R 22,7 to end the function. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, and 
29, 


ADR372W ss (xxx}mmmmm(yy), ALIAS dsname NOT 
RESTORED FOR USER CATALOG catname, 
rc 

Explanation: The user catalog alias was not restored for the 
restored user catalog. The reason code, rc, indicates why, as 


follows: 


00 User catalog aliases are not restored when the user catalog 
is restored to a nonempty preallocated target. 


04 The user catalog for this alias was not restored 
successfully. 


08 A duplicate name exists in the master catalog for the alias. 


12 Acatalog error other than duplicate data set name 
occurred while the alias was being restored. 


System Action: The user catalog alias is not restored. 
Processing continues with the next cata set. The systerm return 
code is 4. 

Programmer Response: The user catalog was restored. To 
define the alias, do the following according to the reason code: 


00 Use the IDCAMS DEFINE ALIAS command to define 
the alias if it does not exist and is desired. 


04 Other messages indicate why the user catalog was not 
restorec. Correct the problem and rerun the restore. 


08 If the duplicate name in the master catalog is an alias for 
the restored user catalog, no action is necessary. If the 
duplicate name is not an alias, correct the problem. If the 
alias is required, define it using the IDCAMS DEFINE 
ALIAS command. 


12 Determine the error from message ADR497E that orecedes 
this message and correct the crociem. Then define the 
alias using the IDCAMS DEFINE ALIAS command. 


Operator Response: None. 
Problem Determination: Tabie I, items 1, 3,4, 13, and 29. 


ADR373E (xxx-mmmmnoi(yy), REQUESTED TRACK (cchh 
| (SOME)} NOT ON INPUT DDNAMIE 
ddname 

Explanation: The track requested for the RESTORE is not on 
the input file. [It was probably not dumped. If the cchh ts not 
printed, then some of the requested tracks are not on the input 
volume, 

System Action: The task ends. Processing continues with the 
next control statement. The return code is 8 if the task is a 
data set RESTORE or a full or tracks RESTORE that does not 
result in an unusable output volume. The return code is 16 if a 
full or tracks RESTORE results in an unusable output volume. 
Subsequent tracks are not restored. 


Programmer Response: Either change the track range 
requested, or RESTORE from a different copy of the backup. 
Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, and 
29. List the second and third records on the input file to 
determine the tracks that are on the input file. See the Dara 
Facility Data Set Services: Diagnosis Guide under “Format of 
the DFDSS Dump Data Set” for descriptions of these records. 





ADR374E (xxx>mmmmm(yy), UNABLE TO OPEN 
DDNAME ddname, xx-vyy 
Explanation: DFDSS was unable to OPEN the indicated data 


set for the indicated reason code (xx). The yyy is the return 
code passed by RDJFCB. The possible reason codes are: 


8 RDJFCB failure. 


10 Invalid parameters passed in JCL. The following are 
the probable reasons: 


¢ SYSIN/SYSOUT data set 

* DISP=SHR coded for the output data set 
* BLKSIZE less than 7892 bytes 

¢ DSORG other than PS 

¢ BUFNO specified. 


12 OPEN failure. 


14 Invalid fle format passed in the JCL. One of the 
following is true: 


¢ RECFM is not FB or F 
* RECLEN is not 80 
¢ BLKSIZE is not a multiple of the record length. 


System Action: The task ends. Processing continues with the 
next control statement. The return code is 8. 

Programmer Response: Correct the parameters in error, anc 
rerun the ic?. 
Operator Response: 
Problem Determination: 
29, and 35. 


None. 


Table I, items 1, 2, 3, 4, 5b, 13, 20, 


ADR375E (XXx}¥mmmmm(yy), DATA SET dsname IS 
PARTITIONED, BUT HAS NO DIRECTORY. 
IT CAN ONLY BE {COPIED|RESTORED} 
TO A LIKE DEVICE 

Explanation: Tne data set is partitioned, but has no directory. 
It can be cocied or restored only to a like device, but no like 
devices were available or usable. 

System Action: Function fails for that data set. The return 
code is 8. 

Programmer Response: Rerun the job, ensuring that a like 
device with sufficient space is availaole. 

Operator Response: None. 

Problem Determination: Table {, items 1, 2, 3,4, 13, 14, 15, 
20, and 29. 


ADR376E (Xxx+}mmmmm(yy), UNABLE TO ACQUIRE 
ADDITIONAL STORAGE FOR THE TASK 
Explanation: Additional storage was required to continue the 
function, but it was not available. 

System Action: The task ends. Processing continues with the 
next contro: statement. The return code is 8. An abend 80A 
might occur curing DFDSS postprocessing. 

Programmer Response: Provide adequate storage by increasing 
either the REGION size, the SIZE parameter, or both, or 
respecify the filtering criteria to reduce the number of data sets 
for the operation. Rerun the job. See the Data Facility Data 
Set Services. User's Guide under “Storage Requirements”’ for 
more information on storage estimates. 

Operator Response: None. 





ADR374E — ADR379E. 


Problem Determination: Table I, items 1, 2, 3,4, 13, 20, and 
29. 





ADR377W ss (xxx}}mmmmm(yy), COMMAND IS NOT 
SUPPORTED FOR DATA SET dsname ON 
VOLUME volser 

Explanation: The COPY, DUMP, or data set RESTORE 
command does not support the data set organization of the 
indicated data set. The volume indicated is the logical volume 
during a RESTORE. The PRINT command does not susport 
split-cylinder data sets or nonintegrated catalog facility VSAM 
data sets. 

System Action: Processing continues for other data sets. The 
return code is 4. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, 25b, 
and 29. 


ADR378I (xxxX}>-mmmmm(yy), THE FOLLOWING DATA 
SETS WERE SUCCESSFULLY PROCESSED 


FROM VOLUME volser 


Explanation: A list of data set names follows this message. 


The volume indicated is the logical volume for a RESTORE. 
System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR379E (xxx}>mmmmm(yy), {OBTAIN ERROR xxxx|NO 
F2/F3 DSCB|NOT F2/F3 DSCBIERROR IN F1 
DSCB|ERROR IN F3 DSCB|TOO MANY 
EXTENTS!INO EXTENTS} [AT CCHH cchh] 
ON VOLUMIE volser FOR 
{DSNAME:CLUSTERNAMIE name 
COMPONENTNAMIE name} 

Explanation: Errors were encountered when the extents for tne 
data set were accessed. The possible errors are: 


* OBTAIN failed wnile the extents for the data set are 
retrieved, 


* The VTOC entry indicated that the data set had more than 
three extents, Out the additional extent descriptions couic 
not be located. The VTOC entry for an ISAM data set did 
not include the ISAM-specific information. 


¢ The record retrieved from the VTOC was not of the 
expected type. 


* The description for one of the first three extents had errers. 


* The descriptions for extents beyond the third extent hac 
errors. 


* Tne numoer of extents was more than the number 
supported (16 for a non-VSAM data set and 123 for a 
VSAM data set). 


¢ The extent information in the VTOC entry is null. 


During a RESTORE, the volume serial is the logical voiume. 
System Action: For non-VSAM data sets, only the retrieved 
extents are processed. If the error occurred during a data set 
DUMP and the data set is restored during a subsequent data 
set RESTORE, only the successfully dumped extents are 
restored. If the error occurred on a VSAM data set, it is not 
processed. The return code is 8. 

Programmer Response: Use [EHLIST to verify the DSCBs for 
the VTOC, If the VTOC does not contain errors, rerun the job 
to dump the data set. Use a prior backup copy of the dump to 
restore the data set if it occurs during a RESTORE. 
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ADR380E 


PoFy a Mar wag 8S 8 


Operator Response: 


—- ADR380E 


$3) aes Bb. Ei GE aes ie go8 ot ced 


None. 


Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, 25a, 
25b, and 29. 





ADR380E 


(xxx+mmmmm(yy), DATA SET dsname NOT 
PROCESSED, {rc|rce-xxx} 


Explanation: The data set was not copied, restored, converted, 
or released. The reason codes, re, are: 


0 


3-XXxXX 


3-004 


3-008 


3-012 


3-016 
3-020 
3-024 


3-048 
3-052 


3-072 


3-076 


3-100 
3-104 
3-116 


3-120 


3-124 


3-132 
3-148 


3-152 


3-156 


3-164 


3-168 


An unmovable/ABSTR/ISAM data set was not 
preallocated. Either the system Coes not support 
allocation of these data sets, or you are attempting 
ohysical restore of a nonpreallocated 
unmovable/ABSTR/ISAM data set. 


Replace was not specified for the unmovabie data set. 


There were unmatched extents cn input and output 
for an unmovabie/ABSTR/ISAM data set. The 
extents of the source unmovabie data set are printed. 


DADSM was unaocie to allocate a data set. The ‘xxx’ 
indicates DADSM (SVC 32) return codes. See your 
System-Data Administration book or MVS/370 
DADSM Diagnosis Reference or MVS/XA Data 


. Facility Product Version 2: Diagnosis Reference for 


more information. 


The dsname of reauest already exists on this volume; 
initial allocation was not possibd.e under the given 
name. 


No room was available in the VTOC. 


A permanent I/O error or an error returned by 
CVAF was encountered. 


Direct access to the absolute track was unavailable. 


ae | 


The requested quantity was unavailable. 

The average recorc .ength is greater than 65535 
bytes. 

The parameter list was invalid. 

The JFCB was invaic or 2 partia. DSCB ceinter was 
specified. 

The DOS VTOC cannot be converted to an OS 
VTOC. 


No space parameter was given for a new data sel, or 
zero space was requested at absolute track zero. 


CYL and CONTIG vequests conrict. 
The space subparameter was invalid. 


. isa Stew OAR] ear Sig in taste = a oc ia 4 
User labels were mel supported. 


DSSIZE =0 and minimum allocation unit is greater 
tnan 0 

DSSIZE ts not a muluple of the minimum a.location 
unit. 


Space request mus: te ABSTR for a DOS volume. 
Overlapping extents were in the \ TOC. 


Overlapping DOS sciit-cylinder extents were :n the 
VTOC. 


DADSM allocation ended because of possibie VTOC 
errors. 


Allocation ended because of DCS stacked pack 
format. 


RACDEF failed; data already was defined. 


30 DFDSS: Messages 


3-172 
3-176 


3-180 


3-184 


o CoC YH 


10 


11-xx 


12 


13-xx 


14 


15 


16 


17 


18 


19 


The user was not authorized to define the data set. 


The installation-wide exit rejected the request with a 
return code of 8. 


The installation-wide exit rejected the request with a 
return code of 4. 


RACF was defined with modeling specified; the 
model was not found. 


The authorization check failed. 


The block sizes of the target and source data sets do 
not match. This can be caused by attempting to 
move a data set created in an N*512 environment to 
a non-N*512 environment, or vice versa. 


The volume sequence number did not match. 
DSORG did not match. 
There was an error in the rename filter. 


The movable data set on the receiving volume is not 
the same size as the data set on the source volume. 
The data set is in use and cannot be scratched and 
reallocated. 


The movable data set on the receiving volume is 
smaller than the data set on the source volume. 
Failure occurred in the scratch; the data set cannot 
be scratched and reallocated. 


The VVDS calls failed. See return code 50 under 
message IDC3009I in the System. Messages for ‘xx.’ 


The extents mapped by the VTOC and VVDS on 
DASD do not match the VVDS on the input logical 
volume. 


Retrieving ihe extents from the VTOC failed. xx is 
2 oDtain 


the ootain 2rror cede. 


Component names do not match. Either the 
component was redefined since the data set was 
backed uc) or iL is a muitivolume data set, and the 
input anc output volumes are different volumes of a 
mullivolume data set. 


The number of components differs on input and 
output. Either the comoonent was redefined since the 
data set was backed up; or it is a multivolume data 
set, and input and output volumes are different 
volumes of a multivolume data set. 


The beginning RBA for the components does not 
match on input and output. The input and output 
volumes are different voiumes of a multivolume data 
set. 


Primary/secondary indicators do not match on input 
and output. The input and output volumes are 
different voiumes of a multivolume data set. 


REPLACE or RENAME (conditional or 
unconditional) was not specified for the movable 
non-VSAM data set, or REPLACE was not specified 
for a VSAM data set. 


The extents mapped by the VTOC do not match the 
VVDS on the output volume. 


20-xxxx,yyyy The data set on the output volume is smaller than 


21 


on the input logical volume. xxxx = data 
component size in tracks (hexadecimal). yyyy = 
index component size in tracks (hexadecimal). 


The VVDS, BCS, or VTOCIX cannot be restored to 
a different volume. 


22 


23 


24 


25 


26 
27 


23 
29 


30 


31 


32 


33 
34 


36 


37 


The ‘ccation of where the unmovable data set is to be 
allocated is not free, and FORCE is not specified. 


The indicated data set is a duplicate data set and 
exists on more than one input volume. 


The creallocated target data set was defined with a 
larz2r controi area size than the source data set. 


DFDSS cannot restore data sets with a volume serial 
of MIGRAT. 


CVOL cannot be replaced. 


Input cutout block cannot be built because one or 
more cr the following conditions exists: 

* Decname is not found. 

* Dcname is aSYSIN or SYSPRINT. 

* Device is not DASD. 

* Device is not supported. 

* Incorrect ranges are specified for DASD. 


The 212.02 return code was unexpected. 


No curput volumes were available because one of the 
follc’#:ng conditions exists: 


* There are no volumes in the output volume list 
that pe the requirements of the target volumes 


* Tne data sel is preailocaied, and its attributes do 
mci match ee of the source data set. (The 


data set is Pi sla or vice versa.) 


e <A‘! volumes of a preallocated multivolume data 
set are not inciuded in the output volume list. 


restore an unmovable 
lumes are specified 
m space as is required by 





* ~7 volumes on which the preallocated VSAM 
L..flers ves.ce Co not maton the volumes listed in 
ing catalog emiry for ine c.uster. This can 
Pes ‘or exammie, if ne preallocated cluster is 
cataloged outside the standard order of search or 

ies a anotner cluster with 
in the standard order 





* ASSAM data set was preallocated on the target 
2.umes, but no catalog entry was found. 
The .>.ame seriais of the preallocated, cataloged 


tan SES SIO at Wetland INI SIR SSRI WAL eae: Seay 
ee . 2S S20 OG ry 


match those of the first 


ated on source 
swas not found. 





entry for an 
d but there was no 


Pre ces = ofa V i. AM user Catalog is nol supported 
DDNAME or INDYNAM Is specified. 


The me name specified with RENAME or 
REN AMELU nace cv exists on the volume. The 
REPLACE parameter cannot oe specified with the 


38 


39 


40 


41 


42 


43 


44 


52 


60 


70 


71 


ADR380E — ADR380E 


RENAME or RENAMEU keywords. REPLACE is 
ignored if it is specified. 


The VVR for a component of the data set was found, 
but no corresponding DSCB was found. 


RENAME/RENAMEU is not supcorted for 
unmovac.e data sets. 


A nonexistent catalog is specified in the 
RECATALOG parameter, but the target data set is 
not SMS managed. 


During onysical restore, the target voiume is not 
SMS managed, but one of the following situations 
occurs: 


¢ The ACS routine returned an SMS storage class. 

* The user specified BYPASSACS with 
STORCLAS. 

* The user specified BYPASSACS without 
STORCLAS, but the source data set was SMS 
managed. 


The NOPACKING keyword was specified for the 
data set, out the preallocated target was on an unlike 
device. 


During chysical restore, the target volume is SMS 
managec, Dut one of the following situations occurs: 


* The ACS routine returned NULL storage ciass. 

* The user specified BYPASSACS with 
NULLSTORCLAS. 

* The user specified BYPASSACS without.. 
NULLSTORCLAS, but the source data set was 
not SMS managed. 

* The cata set is not supported by SMS. 


The source cOmponent is multivoiume, and tne 
preaiiccaiec target is either a different size 
single vc.ime. 

uocated ee is too small and is not tne 
> of a muluivolume data set. 





Allocation of resource failed because DFDSS usec a 
ulility to cerform data mevernent. Processing encs. 
OFDSS :: unaole tc determine the numocer of 





per tracx lor the target device because of an inv2i 
source Caza set blocksize. 
The reauested data set is a PDSE, but MVS/DFP 


Version ? Release 2 or later is not available on the 
system. 


The recuesied data set is a PDSE, out MVS-SP 


Version > Reiease ae or later Is not availac.e on 
the s¥Si2m 

The recussied data set is a PDSE but SMSX ts not 
curren available and/or the PDSE cannot te 


allocatec and accessed at this time. 


The recuested data set is a PDSE, but the targe: 
volume selected is not SMS-managec. A PDSE can 
reside ony on SMS-managed volumes. 


The reauested data setis a PDSE but there is a 
preallocated target data sel that is not a PDSE. 
Dynamic 
set. 


aiiocation failed for DFDSS export data 


The Sele indicator in the VTOC entry is off, stati ng 
that the cata set is not SMS, but the volume is SMS 
managec. 
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System Action: The return code is 8. The data set is not 
processed. 

Programmer Response: Take the following action, depending 
on the reason code (rc): 


0 Preallocate the data set with the size and location of the 
extents tO match those On the source volume, or specify 
FORCE. Rerun the job. 


1 Specify REPLACE and rerun the job. 


2 Copy/Restore of unmovabie/ABSTR/ISAM data sets is 
allowed only if the size anc location of the extents match 
and the data set is preailocated. [nitialize a new DASD 
volume with the VTOC extent matching the input logical 
volume, do a TRACKS COPY/RESTORE to copy the 
VTOC and TRACK 0, and do a data set 
COPY/RESTORE of the failing data set. Use the 
appropriate utility for the type of data set to move the data 
set from the scratch volume to the failing volume. 


3. Take appropriate action according to the DADSM return 
code, 


4 Acquire adequate authorization (RACF or password). If it 
is a checkpoint/restart or system data set, instruct the , 
operator to allow the function to continue. You can also 
change the user authorization exit routine to allow access 
to the data set. Rerun the job. 


5 Copy or restore the data set in the same environment in 
which it was created. 


6 For a multivolume non-VSAM data set, the volume 
sequence number must match. For a VSAM data set, the 
beginning RBA of the cata set on the volume must match. 


7 If itis the same data set, use AMASPZAP to modify the 
DSORG fieic in VTOC entry. Rerun the job. 


8 Correct the RENAME =. 


19 Scratch the data set anc rerun the ‘or. 


C3009 in System 


t1 See return code £5: 


$ 
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aa 
7 
wo 
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nn 
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GQ 
o 
7) 
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ifferent TacKur cccy to restore the data set. 
13 Contact your system orogrammer. 


14 [fit is not a multivolume data set, delete the data set on 
DASD and resubmit the ‘ob. If it is a multivolume data 
set and a RESTORE in which the data set is not restored 
from the correct input icgical volume, resubmit the job to 
restore from tne oroper ‘ozical volume. If it is a COPY, 

wmput anc or outpu: volumes and rerun the 


15. See reason coce number [-. 
16 See reason code number (S. 
17 See reason code number (4, 


18 Specify REPLACE, RENAME, or RENAME- 
UNCONDITIONAL (RESTORE oniy) if it is a 
non-VSAM data set. Soecify REPLACE if itis a VSAM 
data set. 


19 Run the DIAGNOSE command of Access Method 
Services to determine the error. 
20 Delete the data set and redefine it. 


21. For non-SMS-managed Cala sets, restore to the correct 
DASD voiume, or use the LVOL parameter to restore 
from the correct logical volume. For an SMS-managed 
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user catalog, specify the correct DASD volume in the 


~OUTDD/OUTDY parameter, and ensure that the volume 


is in a Storage Class with the guaranteed space attribute. 


Specify FORCE or free the corresponding location on the 
target volume, and rerun the job. 


If it is a multivolume data set, correct the last volume 
indicator and the volume sequence number fields in the 
VTOC, or catalog the data set in the proper sequence in 
the appropriate catalog. Rerun the job. 


Specify RENAME or RENAMEUNCONDITIONAL or 
delete the preallocated target data set, then rerun the job. 


Recall the data set and retry the restore operation. 


Delete the CVOL from the target volume, then rerun the 
job. 


Take one or more of the appropriate actions listed below, 
then rerun the Job: 


* Ensure thata DDNAME statement is present in job 
step. 

¢ Ensure that the ddname is not that of aSYSIN or 
SYSPRINT. 

e Ensure that the device specified is a DASD. 

* Ensure that the device is supported on the system. 

* Ensure that the correct ranges are specified for DASD. 


Refer to message ADR497E, printed before this message, 
and take the appropriate action. 


Take one of the actions listed below; then rerun the job: 
¢ Supply a new choice of output volumes. 


¢ Ensure that the attributes of the source and the 
preallocated target match. 


* Ensure that the data set is cataloged and the catalog 
volumes and output volumes on which it ts 
preallocated match. 


* Restore as a movable data set by specifying the 
FORCE keyword. 


* Supply the name of the cataicgz in which the 
preallocated cluster resides, either by using 
JOBCAT/STEPCAT or the RECATALOG Keyword. 
If the preallocated target cluster is not cataloged in any 
catalog, then either catalog it or delete it. 


¢ Ensure that the preallocated target data set is cataloged 
in the standard order of search. 


Ensure that the correct target volumes for the multivolume 
data set are specified in the output DD statements, then 
rerun the :ob. 


Ensure that a STEPCAT DD or a JOBCAT DD statement 
exists for the catalog with the VSAM data set on it. Ifa 
STEPCAT DD or JOBCAT DD statement already exists, 
ensure that it points to the correct catalog, then rerun the 
job. 


Provide a different choice of output volumes, then rerun 
the job. 


Provide a different choice of output volumes, then rerun 
the job. 


Delete the catalog entry for the failing data set. Full 
volume dump/restore does not allocate data sets. 
However, it does restore all of the data tracks as well as 
the VTOC. Thus, full volume restore can be used to 
restore cataloged SMS-managed data sets with no 
corresponding VTOC entries. 


35 Choose a different name for the target data set or specify 
REPLACE, then rerun the job. 


36 Ensure that the catalog to be moved meets the INCLUDE, 
EXCLUDE, or BY filtering criteria, then rerun the job. 


37 Ensure that the new name spec:ed with RENAME or 
RENAMELU does not already exist on the volume. If the 
new name already exists, it must be deleted or another new 
name must be specified before retrying the command. 
REPLACE is ignored if RENAME or RENAMEU is 
used. 


38 Delete the VVR for the failing component, and rerun the 
job. 

39 Specify REPLACE to replace the unmovable data set 
under the old name, and rerun the job. 


40 Ensure that the catalog name is correct and available if the 


target data set is not SMS-managed, and rerun the job. 
41 Specify either an SMS target or a NULLSTORCLAS. 


42 Delete and reallocate the target partitioned data set on a 
like device, or rerun the job without specifying 
NOPACKING for the data set. 

43 Specify a non-SMS target. 

44 Delete the data set on DASD, and resubmit the job. 

45 Delete the data set on DASD, and resubmit the job. 

46 Rerun the job when the data set is not in use. 


50 Ensure that the source data set has a valid blocksize or 
preallocate a target data set with a valid blocksize. Specify 
the REPLACE keyword. 


52 Process me PDSE using a system that has MVS/DFP 
Version 3 Reiease 2 or greater :nstalled or do not select the 
PDSE. 


54 Process tne PDSE using a system that has MVS/SP 
Version 3 Release 1.OE or greater installed or do not select 
s1e-P DOSE, 


56 Ensure that SMSX :s availiable and that tne PDSE can be 
allocated and accessed on the system. Rerun the job. 

voiume ror the PDSE is 

tne PDSE. 


88 Ensure that tne tarzet 


SMS-managed or do not select 


60 Process the PDSE using the 
RENAME/RENAMEUNCONDITIONAL keywords, or 
rename the orealiocated target data set, or delete the 
Dreallocated tarzet cata set. 


mat caused the allocation to fail 
72, and so on), correct the 


70 Determine tne condition 
‘for exampie, gio aden fails 
error condition, and rerun the ae To bypass the probiem, 
the user musi define a generic crofile with ‘HLQ.*’ 

71 Correct the VTOC entry and rerun the job. 

None, 

Tabte I, tems 1, 2, 3,4, 13, 20, and 

256. Take actions 29 and 35 on 3-43, 3-52, 3-76, 3-100, 3-104 

3-1 116, 3-120, and 3-124. On a RESTORE, dump the VTOC 

track records on the input that are at the beginning of the file. 


Operator Response: 
Problem Determination: 


ADR381E — ADR383W 


ADR381E (xxx}>mmmmm(yy), ALL OUTPUT VOLUMES 
INACCESSIBLE. DATA SETS NOT 
PROCESSED 

Explanation: The OUTDD subparameter is missing, or the 


output volume cannot be opened for a data set COPY or 
RESTORE. Message ADR307E might precede this message. 
System Action: The task ends. The return code is 8. 
Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, and 29. 





ADR382W ss (xxx}mmmmm(yy), THE FOLLOWING DATA 
SETS WERE NOT PROCESSED FROM 
VOLUME volser DUE TO ERRORS 
Explanation: The data sets in the list were not processed. 
Other messages that precede this message identify the error. 
System Action: The return code is 4. 

Programmer Response: Correct the problem according to 
preceding messages. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3,4, 13, 20, and 
293 


ADR383W = (xxx+}mmmmm(yy), DATA SET dsname NOT 
SELECTED 
Explanation: The data set was not selected. This condition can 


occur for several reasons including: 


¢ The fully qualified data set name did not pass the 
EXCLUDE, or BY filtering criteria. 


* Thre data set name was specified more than once in the 
INCLUDE list. 


* Logical input volumes were ee during DUMP or 
COPY and DFDSS was unaoie to locate the catalog in 
wnich tne VSAM data set resides. 


* A VSAM data or index component name was incorrectly 
scecified instead of the cluster name. DFDSS only 
crocesses VSAM data sets at the cluster name level. 


* Tre data set has been migrated (volser = migrat). 


System Action: The data set is not processed. The return code 
is 4, 
Programmer Response: 


following: 


Rerun the job after doing one of the 


¢ Use the proper filtering criteria. 
* Do not duplicate data set names in the INCLUDE list. 


m 


msure any VSAM data sets to be processed are cataloged 
cm tne standard order of search. 
io VSAM cluster names were specified in the 


: tne data set you want is not cataloged, use the correct 
o.ume serial as If you want to operate on the 


the. ane set. 


Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, 25b, and 
29. Iritis a RESTORE, print the VTOC track records on the 
dump tape. 
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ADR384E ADR391E 





ADR384E —s (xxx}-mmmmm(yy), UNCATALOG FAILED 
FOR data set ON volser, {re|rc-xx} 
Explanation: The UNCATALOG operation failed for the 
indicated data set. The return code from the system uncatalog 
operation is given in rc and the reason ccde, if any, in xx. 
System Action: Processing continues. The return code is 8. 
Programmer Response: See the Catalog Administration Guide 
under “Using Catalog Management Macro Instructions for OS 
CVOLs” for an explanation of return and reason codes, and 
take the appropriate action. 

Operator Response: None. 

Problem Determination: Table I, items !, 2, 3,4, 13, 20, and 
29. 


ADR385E (xxx-mmmmm(yy), CATALOG FAILED FOR 
data set ON volser, {rcjrc-xx} 

Explanation: The CATALOG operation failed for the 
indicated data set. The return code from the system catalog 
operation is given in re and the reason coce, if any, in xx. 
System Action: Processing continues. The return code is 8. 
Programmer Response: See the Catalog Administration Guide 
under “Using Catalog Management Macro Instructions for OS 
CVOLs” for an explanation of return and reason codes, and . 
take the appropriate action. 

Operator Response: None. 

Problem Determination: Table [, |, 2, 2. =. 13, 20, and 29. 


ADR386W = (xxx}mmmmm(vy), UNIT NAME xxxxxx OF 
LOGICAL VOLUME volser DOES NOT 


MATCH ANY OUTPUT VOLUME DEVICE 


TYPE 
Explanation: None of the cutput DASD volumes matched the 
device type of the source volume on the incut file. The xx is 


the esoteric un 
restore to an un 
System Action: 







@ is 255 issued if you trv to 
ca. data set dump ‘ape. 
tne next source 






volume, if any, on the input file. The return cede is 4. 

Srernvney Response: giv the matcning outsut DASD 
Olume, and rerun ithe job. Iv you want io restore to an unlike 

Suck, Use a icgica. cata set cum Llare. 

Operator Response: None. 

Problem Determination: Tabdie [. items *.72,3,4, 13,20, and 

29. 

ADR387E (Xxx}mmmmm(yy), THE FOLLOWING 


LOGICAL VOLUMES DID NOT PROCESS 
FROM DUMP FILE: 


anions Ts re user requested a data ESTORE from 





the listed tog rorimes from the incu: ut the logicai 
volumes arg the inout Tie A Sst ot welche serials 
roucws the messaze. 

System Action: Tre raturn ig 8. 

Programmer Response: .O source Volume was processed, 





use the correct RESTORE Nie or the correct source volume 
serial numbers, and rerun the fob. 

Operator Response: None. 
Problem Determination: Ta! 


bie [, items i, 3,4, 13, 20, and 29. 


(Xxx-mmmmm(yy), DATA SET dsname NOT 
ON ANY VOLUME. 

Explanation: The requested data sets are not on the source 
volumes on the input file. E:ther the wrong input file was used, 
an incorrect data set name was passed, or = the VSAM data 
sets or all the non-VSAM Gata sets were rejected because of the 
DSORG filtering criteria. This message is pri canted if fully 
qualified names are passed and there are no allocated data sets 
oy that name cn those volumes. 

System Action: The return code is 4. 


ADR383 W 
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Programmer Response: Correct the error, and rerun the job. 
Operator Response: None. 

Problem Determination: Table [, items 1, 2,3, 4, 13, 20, and 
29. Use INCL(**) and the NORUN keyword to list all the 
data sets on the volume. 


ADR389E (xxX}mmmmnm(yy), INVALID INPUT ON 
DDNAME ddname, {INPUT DATA SET NOT 
PRODUCED BY DFDSS | DATA SET 
RESTORE NOT FEASIBLE FROM TRACKS 
DUMP |! VSAM DATA SET RESTORE NOT 
FEASIBLE FROM RELEASE 1 DUMP | 
ONLY VSAM DATA SETS ON INPUT | 
ONLY NONVSAM DATA SETS ON INPUT | 
FULL RESTORE NOT FEASIBLE FROM 
TRACKS OR DATA SET DUMP | EXPECTED 
INPUT RECORD NOT FOUND | INPUT 
VOLUMES MOUNTED OFF SEQUENCE} 
Explanation: Either the input is invalid for the type of 
RESTORE desired or the input was not produced by DFDSS. 
(For example, a dump tape was created using a data set 
DUMP and you tried to restore it via a full RESTORE.) If 
unlabeled tapes were used, ee Puan have mounted them in 
the wrong sequence. 

System Action: The task ends. Processing continues with the 
next control statement. The return code is 8. 

Programmer Response: Taxe the appropriate action, depending 
on the error, and rerun the job. 

Operator Response: None. 

Problem Determination: Tabie I, items |, 2, 3,4, 13, 20, and 
29. 


ADR3901 (xxx}mmmmm(yy), DATA SET dsname WAS 
SCRATCHED FROMI yolser BECAUSE OF 
UNMATCHED SIZE. IT WILL BE 
REALLOCATED. 

Expianation: The movadie data set’s SIZE fin tracks) on the 
DASD volume was not equai to the data set SIZE on the tape. 


Because REPLACE was scecifed instead of RENAME or 
Bee ee fon RESTORE), the data set 
was scraiched to allocate tne extents macced in the input 
logical volume. 

System Action: Overation continues. [f allocation is feasitie 
on this volume, message ADR396I follows this message. If 


allocation is not feasidie on this voiume, message ADR38CE 
and/or message ADR472E follows this message. 
Programmer Response: If reallocation fails, preallocate the 
data set with adequate space, and rerun the joo. 

Operator Response: None. 

Problem Determination: Taoie [, items i, 2,3, 4, 13, 20, and 


w 


ADR39tE (xxx>mmmmm(yy}, RESTORE OF dsname 
REQUIRES OUTPUT VOLUMES 
Explanation: The mnamec data set was not cataloged when 
aumped. Because neither the dump catalog information nor 
12 Original source volumes are availadie for allocation, the 
siitput volumes must ce specified to restore the data set. 
System Action: Processing ends for the data set. The return 
code is 8. 
Programmer Response: Specify at least one output volume 
using OUTDD or OUTDYNAM, and rerun the restore. 
Operator Response: Nore. 
Problem Determination: Tabie |, items i, 3,4, 13, and 29. 


ADR392E (xxx}-mmmmm(yy), dsname EXISTS ON volser 
WITH NEWNAME newname 

Explanation: Allocation of the data set using the name 
generated from the RENAME parameter was attempted, but a 
data set with the new name exists on the volume. 

System Action: Message ADR380E might follow this message. 
The return code is 8. 

Programmer Response: Either scratch the existing data set 
with the name created from the RENAME parameter, or use 
another name in the RENAME parameter to generate a data 
set name that does not exist on the volume. Rerun the job. 
Operator Response: None. 

Problem Determination: Table I, items 
and 29. 


1,2, 3, 4, 13, 20, 25a, 


ADR393I (xxx+}mmmmmnm(yy), ALIAS dsname RESTORED 
FOR USER CATALOG catname 

Explanation: The user catalog alias was restored for the 
catalog. 

System Action: None. 

Programmer Response: None. 

Operator Response: None. 


Problem Determination: None. 


ADR394W ss (xxx}mmmmm(yy), UNABLE TO ALLOCATE 
dsname ON volser WITH NEWNAME dsname 
Explanation: Ailocation of the data set using the name 
generated from the RENAME parameter was attempted, but 
the allccation Failed. 

System Action: This message is preceded by another error 
message, indicating the reason for the failure. The return code 
is 4. 

Programmer Response: Appropriate responses are listed under 
the oréceding messave: 


Operator Response: None. 


Problem Determination: Table {, items 1, 2,2, 4, 13, 20, and 
29. 
ADR3Y9Si {xXx+>mmmmm(y¥y), DATA SET dsname 


LLOCATE {AS A PDS} WITH NEWNAMIE 
dsname 5, {N CATALOG catnamej, ON 
nore) {volser | volser list) 

Explanation: [ne data set nas beer. a.:ccated on the voiume or 
voiumes isted with tne NEWNAME zenerated from the 
RENAME parameter. If the data se. is a VSAM cluster, the 
catalog name may be listed as well. [f the target data set of a 
PDSE is aliccated as a PDS, the new target type is listed as 
well, anc tne cata set is converted to the new target tyne. 
System Action: Nore. 

Programmer Response: None. 

Operator Response: Nore. 

Problem Determination: Tadie I, items 1, 3,4, 13, 20, and 29. 


ADR3I6I (xxxX+}mmmmm(yy), DATA SET {dsname | 
CLUSTER clusname COMIPONENT compname} 
ALLOCATED [AS A PDSTE, IN CATALOG 
catname} , ON VOLUMIE(S): {volser | volser 
list} 

Explanation: The data set has been aiiocated on the volume or 
volumes iusied. If the data set is a VSAM cluster, the catalog 
name may ce listed as well. If the target data set of a PDSE is 
allocated as a PDS, the new target type is listed as well, and the 
data set is converted to the new target type. 


 ADR392E — ADR397E 


System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3,4, 13, 20, and 29. 





ADR397E (xxx>mmmmm(yy), DATA SET dsname NOT 
{COPIED | RESTORED}. DATA BLOCKSIZE 
OF biksize EXCEEDS TARGET DEVICE 
TRACK CAPACITY OF trksize. 

Explanation: DFDSS allocated or located the target data set 
ona DASD device with the indicated track capacity. This was 
done because the clock size of the source data set was less than 
the track capacity of the target device. However, during 
processing, DFDSS encountered a data block from the source 
data set that was larger than the track capacity of the target 
device. The data block cannot be placed on the target device, 
so the DFDSS function fails for the data set. 


This situation can occur only when the track capacity of the 
target device is less than that of the source device. DFDSS 
allocates to such a device only when target.volumes of same, 
like, or larger track capacity are not specified or are specified 
but do not have space available. 

System Action: The specified data set is not processed. If 


- DFDSS allocated the target data set, it is deleted. The return 


code is 8. 
Programmer Response: Perform one of the following actions, 
and rerun tne job: 


¢ Provide DFDSS with a target DASD device with a track 
capacity iarge enough to contain the block size specified in 
the message, by using OUTDD or OUTDYNAM. Specify 
only target volumes that have a track capacity larger than 
the block size specified in the message. This includes 
volumes of the same or a like aevics type as the source and 
any volumes of a device type witn a large tracx capacily 
You must aisa eliminate the REPLACE keyword if a 
2 at is eee on a device with a smailer 
track capacity tran the block size indicated in the message. 
2 Larzet data set ona veiume with a track 
to contain the block size es in 
he message. Scecify the volume to Rae us 
OUTDD o or OLTDYNAM anc use tne REP ACE 
keyword to Force DFDSS to use the preallocat ee lar 


z 
ore . 3 ~ ~ Nae {4 
ine carze: cevice smouid meet the conditions speciiied in 
! 











* Specify the REBLOCK keyword. If the source data set 
can be rebdlocked and the source data set logica! record 
length is iess than the target track capacity, DFDSS 
reblocks the cata set as it is cocied or restored. Certain 

eblocked. so one of the soiuhons 

. Whether or not the cata set 

Bon specifying REBLOCK 


Fans again, use one of the 


data sets cannet be 





* If you were cerforming a COPY, you can update the 
source VTOC entry io reflect the block size specified in the 
message ov using AMASPZAP if you are authorized to 
use it. When Sob is rerun, DFDSS will select a usable 
target volume Dased on the updated block size. 





Operator Response: None. 
Probiem Determination: Table [, items 1, 3, 4, 13, 20, 25b, 25c, 
and 29. 
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“ADR398W 


— ADR4USE 


ADR398W = (xxx mmmmm(yy), DATA SET dsname | 
BLOCKSIZE OF blocksize IS INCORRECT. 
LARGEST BLOCKSIZE IS blocksize 
Explanation: While performing a COPY or RESTORE of the 
data set, DFDSS encountered at least one data block whose 
size exceeded the maximum block size specified in the VTOC. 
The data set is copied or restored with the block size intact. 
The largest block size found is indicated. 

System Action: Processing continues for the specified data set. 
The return code is 4. 

Programmer Response: Take appropriate actions to correct 
this situation. 

Operator Response: None. 

Problem Determination: None. 





ADR401IW UNEXPECTED RETURN CODE xxxx 
REASON CODE yyyy FROM UCBLOOK 
MACRO. VOLUME ON UCB 2272z IS MADE 
UNAVAILABLE. 

Explanation: UCBLOOK macro returned unexpected return 


code while DFDSS was trying to check for a duplicate 
VOLSER. Return and reason code are in decimal. zzzz 
represents the device number. 

System Action: Processing continues. Volume on UCB 22zz is 
made unavailable. The return code is 4. 

Programmer Response: This message is not normally expected 
and indicates a programming or system problem. Ensure that 
no duplicate VOLSER exists. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4,5, 13, 20, 29, 
and 35. 


ADR402E (xxx}mmmmm(yy), AUTHORIZATION CHECK 
FAILED FOR dsname, [ON VOLUMIE volser, | 
re‘IN CATALOG catname} 

Explanation: The author:zation check fatied for the indicated 


reason code, rc. Tne possicie reason coces are: 


1 The operator srecified 7 to message ADR369D, which 


denies access :¢ one of ine following: 


— Acheckrointrestart cata set 

— A RACF cata set on a non-RACF system 

— AVVDS cr VTOCIX data set or an integrated catalog 
facility-cataioged VSAM data set on a nonintegrated 
catalog facility system, or 

Input/output errors were encountered on the VTOC or 


VVDS. 
2 RACF UPDATE authorization failed for the data set 
name. 
3 RACF ALTER autnor:zation failed for the data set name. 
4° RACF READ authorization failed for the data set name. 
5 The user autnorization exit rejected the voiser. 
6 The user authorization exit rejected the data set name. 
7 The passwore was not supplied for the data set name. 
8 READ password was specified, but WRITE password was | 


required. | 
9 The password was incorrect for the data set name. 


10 Anerror occurred while tne PASSWORD data set was 
being accessed. 


11 OPEN failed while verifying the password for the VSAM 
data set. 
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12 Duplicate or missing cluster entries for the data set in the 
VVDS. 
13 The expiration date did not pass for the data set name. 


14-xxx-yyy The authorization check failed for the VSAM data 
set. The xxx and yyy are the return codes and reason 
codes from catalog services. See return code/reason code 
under message [DC3009I in System Messages for an 
explanation. 


15 The return code from the user authorization exit is invalid. 
16 No access to the volume was passed. 
32 One of the following conditions occurred: 


¢ Permanent error while reading the VTOC, VVDS, or 
the password data set and the operator denied 
permission to continue 


¢ Unable to get the storage required 
* Permanent error on the password data set. 


System Action: Other messages indicate the actions taken for 
the various conditions. The return code is 8. 

Programmer Response: For all reason codes except code 14, 
acquire proper authorization for the data set, and rerun the 
job. (For code 2, 3, or 4, authorization may have failed | 
because of other attributes, for example, SECLEVEL.) For 
cede 14, see return code/reason code under message [DC3009I 
in the System Messages manual. 

Operator Response: None. . 

Problem Determination: Table I, items 1, 2, 3, 4, 5b, 13, 20, 
and 29. 


ADR404E (xxx}>mmmmm(yy), COMMAND NOT 
ALLOWED ON AN OPEN CATALOG, 
CATALOG catname 

Explanation: A COPY or RESTORE of a catalog is not 
2..0wed on an open Integrated Cataiog Facility catalog. 

System Action: The data set is not processed. The return code 
is 8. 

Programmer Response: 
active on the system. 
Operator Response: None. 

Problem Determination: If the catalog is not open, take a 
SYSABEND on message ADR&O-E. Table [, items 1, 3, 4, 5, 
13, 20, 29, and 35. 


Run the oo when the catalog is not 


(xxx-mmmmm(yy), DYNAMIC ALLOCATION 
OF VOLUME volser FAILED. ERROR CODE 
eeee. INFORMATION CODE iiii 

Explanation: DFDSS attempted :o dynamically allocate the 
indicated volume and failed. The error and information codes 
are returned by dynamic allocation and listed in the System 
Programming Library: Application Development Guide. Error 
code X'049C' can result iff (1) the volume is online and not 
mounted, and (2) the unit name was not passed because 
DFDSS tried to allocate the volume as a virtual volume after 
ajlocation as a real volume had failed. An undocumented error 
code can be displayed if an installation-wide validation exit is 
used to deny allocations for dynamic allocation but fails to get 
the reason code returned by dynamic allocation. 

System Action: The task or volume is bypassed. The return 
code is 8. 

Programmer Response: Correct the problem indicated by the 
error and information codes listed in the System Programming 
Ligrary: Application Development Guide. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2,3, 4, 13, 20, and 
29. 





ADR405E 





ADR406E (xxxX}mmmmm(yy), dsn CANNOT BE 
RESTORED FROM ddname 

Explanation: The specified data set, dsn, cannot be restored 
from the logicai dump data set assigned by ddname. This 
situation occurs when you attempt to restore one of the 


following: 
* An ISAM Gata set 
¢ A CVOL to an unlike device 


* A BDAM Gata set io an unlike device with a target track 
capacity smaller than tne source track capacity without 
specifying the FORCE xeyword. 


System Action: The indicated data set is not restored. The 
return code is 8. 

Programmer Response: [f the data set is an ISAM data set or 
a CVOL, rerun the job, specifying a like device type as the 
target of RESTORE. If the data set is a BDAM data set, 
specify the FORCE keyword and rerun the job. 

Operator Response: Nore. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR407E (xxx}mmmmm(yy), UNABLE TO FIND 
j MODEL VOLSER FOR MODEL ENTITY 
{model entity name | vsam catalog name} 
Explanation: The model entity (MENTITY) supplied was not 


found in the standard caia:og search order or is a VSAM data 
set cataloged in a nonintegrated catalog facility VSAM catalog. 
System Action: The COPY or RESTORE is ended. The return 
code is 8. 

Programmer Response: Verify that the spelling is correct for 
the MENTITY supplied and that it is cataloged in one of the 
catalogs used in the standard catalog search order; or ensure 
that the MENTITY is net cataloged in a VSAM catalog. Then 
rerun the job, 

Operator Response: None. 

Problem Determination: Taoie I, items 1,3, 4, 13, 20, and 29. 


ADR4AO8E (skx}mmmmmivy) LOCATE FAILED FOR 
CATALOG catname 

Explanation: An error cccurred in attempting to locate the 
volser of the catalog name containing the VSAM model entity 
System Action: The COPY or RESTORE :s ended. The return 
code ts 8. . 

Programmer Response: Use IDCAMS to define the catalog 
specified in this message, and rerun the job. 

Operator Response: Nore. 

Problem Determination: Taodle I, items 1, 3, 4, i3, 20, and 29. 


ADRA09E (xxx}¥mmmmm(yy), CLUSTER clusname HAS 
PRE DFP31)0 VVRS WHICH ARE 
iNCOVIPATIBLE WITH SIS 

Explanation: Cluster was created by a version of DFP prior to 
DFP 2.1.0. Trerefore, the YVRS for the cluster do not contain 
all tre fields necessary for SMS, even thougn an SMS subcell 

12 VVRS. 

The voiume is left in its initial status. The 


was added to th 
System Action: 
return code ts 8. 

Programmer Response: REPRO the data out of the data set, 
delete the data set, then recreate the data set on DFP version 
3.1.0 or later system. [f sou have a large number of these data 
sets, contact vour IBM service representative. 

Operator Response: Nore. 

Problem Determination: None. 


“ADR406E  — “ADR4i4 0: 


aa 


(xxx}+}mmmmm(yy), DATA SET {dsname | 
clustername COMPONENT componentname} 
[IN CATALOG catname] ON VOLUME volser 
WAS NOT SERIALIZED ON REQUEST 
Explanation: An ENQ(EXCLUSIVE), ENQ(SHAREB), or 
dynamic allocation with DISP =OLD or SHR failed after a 
specified (or defaulted) number of retries. TOL(ENQF) was 
specified by the installation-wide exit or by the user. 

System Action: If you were doing a COPY and DFDSS is 
moving the data itself, the data set is processed without the 
enqueue, and the return code is 4. If you were doing a COPY 
and DFDSS invokes a utility to move the data, the data set Is 
not processed further, and the return code is 8. If you were 
doing a data set DUMP, the data set is processed without the 
enqueue, and the return code is 4. If you specified RESET on 
the data set dump, the data set is processed, but the data set 
changed indicator is not reset in the data set’s VTOC entry. 
Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2,3, 4, 13, 20, and 


ADR411W 


29. 

ADR412E (xxx}mmmmm(yy), DATA SET 
{dsnamejclustername COMPONENT 
componentname} [IN CATALOG catname] ON 
VOLUME volser FAILED SERIALIZATION 

Explanation: An ENQ(EXCLUSIVE), ENQ(SHARE), or 


dynamic allocation with DISP=OLD or SHR failed after a 
specified (or defaulted) number of retries. TOL(ENQF) was 
not specified by the user. 

System Action: The data set is not processed. The return code 
is 8. 

Programmer Response: Rerun the job when the data set is not 
in use by other users. You can increase the WAIT parameters, 
and :f you are not using tne COMPRESS command to 
compress a PDS, you can specify TOL(ENQF). 

Operator Response: None. 

Probiem Determination: Table I, items |, 3,4, 13, 20, and 29. 


ADR4AI3E (XxXx}¥mmmmm(yy), DATA SET dsname ON 
VOLUME volser WAS NOT {DELETED ! 
UNALLOCATED,} {xxIxx-yyyy : zzzz} 
Explanation: The data set camnot-ce scratched, uncataicged, or 
unaiuocated via dynamic allocation. The error codes (xx} are: 


0 dynamic allocation installation-wide validation routine 
denied the request. The reason code is z22zz. 


1 dynamic allocation information error code is yyyy. The 
reason code 1s zzzz. Tne codes are explained in the Sysrem 
Programming Library: Apolication Deveionment Guide, 
GC28-1352. 


Nw 


[EFAB4C3 was called to release data set integrity ul it 
failed. 


System Action: The return code is 8. 

Programmer Response: Scratch the data set by other means. 
Operator Response: None. 

Problem Determination: Tabie I, items 1, 2, 3,4, 13, 20, and 
29. 


ADR4I4E (xxx}mmmmm(yy), DATA SET dsname ON 
VOLUME volser NOT SCRATCHED, 

{XX |Xx-yy,zzz} 

Explanation: The data set cannot be scratched. The error 


codes (xx) are: 
0 DEQ on the data set failed. 


1 The initiator enqueued the data set. 
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2 The scratch failed. The yy is the return code and/or status 
code. The zzz is the reason code from DADSM 
SCRATCH, as descriced in the System-Data 
Administration. 


System Action: The return code is 8. | 


Programmer Response: Sc-2:ch the data set by other means 

Operator Response: Nore. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, and 

29. 

ADR41ISW ss (xxx+}mmmmmivy), NO DATA SETS WERE | 
COPIED, DUMPED, OR RESTORED FROM | 
{ANY VOLUME | VOLUME volser | 
LOGICALVOLUME volser} | 

Explanation: A data set COPY, dataset DUMP, or data set 

RESTORE did not select any data sets. One of the following 

applies: 


* No data sets matched :ne filtering criteria. 


* Data sets maiched the *iitering criteria but failed 
serialization or authorization and were not processed. 


¢ Permanent I/O errors cccurred on the output tape during 
the DUMP process. : 


System Action: If I/O errors occurred on output during 
DUMP, the return code is set to 16; otherwise, it is set to 4. If 
i,O errors, anc if the failure was on one volume, 


there were no |, 
other volumes will be processed. a 
Programmer Response: Nore. | 
Operator Response: None. 
Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, 25b, | 


and 29. If it was a RESTORE, print the VTOC tracks on the 
dump tape. 
ADR4I16E (XXX¥mmmmm vv), DATA SET dsname (IN 


CATALOG catmame! WAS NOT DELETED, re 
Explanation: Txe data se: +25 not deleted for one of the 
following reasons: 





) OFDSS éces not support 
1 rors, suc. as authorization or enqueue 
lata sel, o7 mo catalog entry was 
foe 5 : | 
2  Ejther the cata set is mola single-voiume data set, or it | 
cannot ce determined :7 tne data set is single volume or 
muitive.ume and it is nc. presently cataloged. 
3. The data set was not encueued by DFDSS. 
4 The cata se. was not cricessed. i[t.s probably an empty 
data set 
5 The cata set nas not exc:red by the exoiration date. If this 
return occe is received [ir a data set COPY, the dsname 
apoearing in the messaie is a temporary name that 
DFDSS zenerated to orocerly name the data set on the 
target vo.ume. You must now de.ete the data set with the 


temporary name from in2 source voiume. 


System The data se: :s not deleted. The return code is 
8. 

Programmer Response: De.ete the d 
For reason code 5, specify PURGE to 
data set. 

Operator Response: 
Problem Determination: 


and 29. 


Action: 


ata set by other means. 
Geiete the unexpired 


None. 


Tar.2 [, items 1, 2, 3,4, 13, 20, 25a, 
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ADR417W ss (xxx}mmmmm(yy), COPY/RESTORE OF 
DATA SET dsname IS INCOMPLETE, re 
Explanation: The data set was copied or restored, but errors 
occurred during processing; or the data tracks were not copied 
or restored because the VTOC entry could not be reset; or the 
RACE indicator could not be set for the data set. The reason 


code (rc) is as follows: 


0 The protected data set was copied or restored, but 
definition of the RACF discrete profile failed. 


1 The data set was copied or restored, but the VTOC entry 
cannot be retrieved for updating. 


2 The data set was copied or restored but errors occurred 
while the VTOC entry was being updated. 


3 For physical data set RESTORE, the data set is restored 
but I/O errors occurred on one or more tracks of the data 
set (resulting from errors during dump). For logical data 
set RESTORE and data set COPY, no further data is 
copied or restored. If the data set was not preallocated, it 
is deleted. 


4 A RACF-protected data set was copied or restored to a 
system that does not support RACF. 


5 The data set was not copied or restored because the VTOC 
entry cannot be retrieved to set the RACF indicator or be 
updated for the cata sel. 


6 The data set was not copied or restored because errors 
occurred while the VTOC entry was either being rewritten 
to reset the RACF indicator or being updated for the data 
set. 


7 The target VSAM data set cannot be protected with a 
discrete RACF profile because it was not renamed, the 
targel Catalog resides on ine same volume as the source 
catalog, and a discrete RACF orofile already exists for the 
source data sei. 


8 The data set was not copied because a track overflow 
record was found in tne data set. 
he return code is 4. 
ne acuon, depending 


Processing continues. 
Take the follow 


System Action: 
Programmer Response: 
on the reason code (rc): 


0 Define the data set to RACF. 


1 Use AMASPZAP to reset the relevant fields in the VTOC 
entry for the data set, or scratch the data set and rerun the 
COPY or RESTORE. 


2 See reason code i 
A +h j ee fer 4 aber: ~ 
3 On input errors, restore the data set from a backup copy. 
On Gulput errors, take corrective action recommenced in 
your site, and rerun the jap 


4 Password- 


53 Use AMASPZAP to reset 
the job. 


protect tne data set. 


the RACE indicator, and rerun 


6 Correct the srobiem for the system I/O error message that 
precedes this message, and rerun the job. 


The data set does not have the RACF indicator set. If the 
source data set was deieted, define the target data sett 
RACF. [f the source data set was not deleted, you can 
define the target data set to RACF with a generic profile. 
However, in an always call (RACF 1.5 or greater) 
environment, the data set is protected by the discrete 
RACE orofile. 


8 Use an appropriate system utility to copy the data set. 


Operator Response: None. 


Problem Determination: Table [, items 1, 2, 3, 4, 13, 20, 25b, 
and 29. 


ADR418I (xxx}-mmmmm(yy), THE FOLLOWING 
COMPONENTS FOR CLUSTER clustername 
ON volser MAY HAVE TO BE CATALOGED 
IN CATALOG catname 

Explanation: The cluster that did not exist on the volume was 
copied or restored to the volume. VTOC and VVDS entries 
were created on the volume for the cluster. If the indicated 
catalog does not have entries for the cluster, you must 
recalalog the ciuster before accessing the data set. 

System Action: None. 

Programmer Response: Use the Access Method Services 
DEFINE RECATALOG command to recatalog the 
compenents and cluster in the indicated catalog before 
accessing the data set. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3,4, 13, 20, 25b, 
and 29. 


ADR419W  (xxx}mmmmm(yy), CLUSTER clustername IN 
CATALOG catname ON DASD WITH 
{INHIBIT UPDATE | OPEN} INDICATOR 
WILL BE COPIED OR RESTORED 
Explanation: A fully qualified name was passed for the data 
set. [tis copied or restorec aithougn :t nas the indicated 
condition. The inhibit-update indicator means that the data set 
is a read-only copy of a data set. Oren-for-update means that 
the data set was in the OPEN status. Either it was not closed 
correctly or it was in use by another job on the same 
processing unit. 

System Action: If the data set had the inhibit-update indicator 
in the VVR, this indicator is left on. If the data set had the 
OPEN | indicatcr, this indicator is reset. If the input copy nad 
tne OPEN incicator, tmis is Carried cer to output DASD. The 
return code is =, 

Programmer Response: if message ADR411W accompanies 
this message, “ne data set was in use “wren the COPY or 


RESTORE was cone. Tre cata se: on the target volume may 
taerefore be invalid. Reorocess the cata set without specifying 
TOLCENQF). 

Operator Response: Nore. 

Problem Determination: Taoie I, items 1, 2,3, 4, 13, 20, 25b, 
and 29. 

ADR420E (xxxX}mmmmm(yy), (¥ ¥ DS|VTOCIX} DATA 


SET CANNOT BE RESTORED WITH 
{OTHER VSAM | ANY OTHER} DATA 


SET(S) 
Explanation: Restore of ine VY DS <2ta set is not ailowed with 
restore of other VSAM cata sets from the same !cgical volume. 
Restore of the VTOCIX cata set is not allowed with restore of 


other data sets fram the same logical vyoiume. 

System Action: Tre volume is not processed. The return code 
is 8. 

Programmer Response: [f the VVDS cata set and other 
VSAM data sets need to be restorec :7om the same input 
logical volume, rerun the iob by passing two RESTORE 
commands, Restore the VV DS on the first RESTORE 
command, and restore other VSAM cata sets on the second 
RESTORE command. If VTOCIX cata set and other data sets 
need to be restored from the same input logical volume, rerun 
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the job by passing two RESTORE commands. Restore the 
VTOCIX on the first RESTORE command, and restore other 
data sets on the second RESTORE command. The return code 
is 8. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2,3, 4, 13, 20, and 
29. 





ADR421E (xxx}mmmmnmi(yy), DATA SET dsname NOT 


PROCESSED, FULLY QUALIFIED NAME 
NOT PASSED, n 
Explanation: A ‘fully qualified name was not passed for a data 
set COPY, DUMP, or RESTORE. The 7 in the message can 
be: 


1 For a VVDS during RESTORE 

2 For a catalog during COPY, DUMP, or RESTORE 
3. For a read-only data set during COPY or RESTORE 
4 


For a data set that has the OPEN-for-update indicator 
during DUMP or COPY 


For the VTOCIX data set during RESTORE 


74) 


6 For a fully qualified cluster name not passed when only the 
index component exists on the volume 


7 For SYS1.STGINDEX data set during RESTORE 
8 For a multivolume data set during DUMP. 


System Action: The data set is not processed. The return code 
is 8. 

Programmer Response: Resubmit the job by passing the fully 
qualified name. 

Operator Response: None. 

Problem Determination: Table [, items |, 
and 29. 


2,3, 4, 13, 20, 256 


ADR4221 (xxX>mmmmm(yy), LOGICAL VOLUME volser 
BYPASSED BECAUSE IT ONLY HAS 
{VSAM | NON-VSAM?: DATA SETS 
Explanation: Tne requested type of cata sets is not on the 
logical voiume. 

System Action: The volume is bypassed. Data set RESTORE 
continues with otner cogicai volumes. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table {, items 1, 3, 4, 13, 20, and 29. 
Print the first record on the dump tape. It identifies the type of 
DUMP and whetner VSAM or non-VSAM data sets exist on 
the volume. 


ADR423W  (xxx*¥mmmmm(yy), SELECTED DATA SET 

dsname IS A MULTIVOLUME DATA SET 

Explanation: A f.lly qualified name was passed in the 

INCLUDE parameter of a data set DUMP or RESTORE 

command. This ‘s a multivolume data set. The data set from 
all of the volumes might not have been processed. 

System Action: The return code is 4. 

Programmer Response: Make sure that the entire data set 

from all of the voiumes on which it resides was processed. If 

not, rerun the joo oy passing the LVOL parameter and 

corresponding DASD volumes to process the entire data set. 

Operator Response: None. 

Problem Determination: Table I, items |, 3, 4, 13, 20, and 29. 
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ADR424E (xxx}mmmmm(yy), AN ERROR OCCURRED 
WHILE RETRIEVING {(VVDS|[VTOCIX} 
EXTENTS FROM VOLUME volser, re 
Explanation: DADSM OBTAIN returned an error code (rc) 
while the VVDS or VTOC extents were being retrieved from 
the indicated volurme. See your System-Data Administration 
book for an explanation of the OBTAIN error codes. 
System Action: If it is a data set COPY or DUMP, the 
volume is bypassed. The command is ended on a data set 
RESTORE. The return code is 8. 

Programmer Response: Take corrective action for the error, 
and rerun the job, 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, and 
29. 


ADR425E (xxx}mmmmm(yy), CONFLICTING BY 

CRITERIA SPECIFIED 

Explanation: Either VSAM and non-VSAM data sets were not 

wanted or VSAM data set processing was not supported on the 

syste. 

System Action: The command ends. The return code is 8. 

Programmer Response: Correct the BY criteria in the 

command, and rerun the job. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2,3, 4, 13, 20, and 

29. 

ADR426W ss (xxx}mmmmm(yy), EXTENT 1 SIZE OF 
OUTPUT PARTITIONED DATA SET dsname 
IS SMALLER THAN EXTENT 1 SIZE OF 
INPUT 

Explanation: The first extent of a newly allocated partitioned 

data set is smaller tnan the one tnat existed during DUMP. 

For cartitioned caia sets, the directory must be in the first 

extent. This message ‘s issued cecause DF DSS cannot 

determine the size or the directory to verify that it can fit in the 

first allocated extent. 

System Action: Tne cata set is restored. The return code is 4. 

Programmer Response: Checx ‘nat the directory is in the first 

extent. Do this oy running [EHLIST with the LISTPDS 

option. If the members cannot be listed, scratch the data set 

and try to obtain 4 .arger contiguous extent oy running 

DEFRAG, then restore the data set. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, 2Sc, 

and 29. 


= 
—) 
a 


ADR427E (xxXx}mmmmm(yy¥), ERROR IN {VVDS|VVDS 
IMAGE} ON {(VOLUME|LOGICAL 
VOLUME} volser WHILE ACCESSING 
COMPONENTS OF CLUSTER clustername 
IN CATALOG catname 

Explanation: DFDSS found errors while retrieving 
components for the cluster during a COPY, DUMP, or 
RESTORE. Some components cannot be located for the 
cluster in the VVDS or VVDS image, or, if it was a 
RESTORE, the VVDS was not dumped successfully during a 
full volume DUMP. Inconsistencies exist in the VVRs, or the 
VVRs have invalid formats. 

System Action: The data set is not copied, dumped, or 
restored. The return code Is 8. 

Programmer Response: [f it is a RESTORE, use a different 
backup copy of the data set, and rerun the job. Ifitisa 
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DUMP, run Access Method Services DIAGNOSE against the 
data set to determine the nature of the error, and take the 
action recommended. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20,29, and 
36b. 


ADR428E = (xxx}}mmmmm(yy), VTOC ENTRIES NOT 
FOUND FOR CLUSTER clustername IN 
CATALOG catname ON (VOLUME 

volser;| LOGICAL VOLUME volser} 
Explanation: VTOC entries are missing for one or more 
components of the cluster on the volume. For a logical 
volume, the error is in the source volume and was not detected 
during DUMP. 

Programmer Response: If the operation was not a RESTORE, 
run Access Method Services DIAGNOSE to detect the error 
and take the actions recommended. If the operation was a 
RESTORE, use a previous backup copy, and resubmit the job. 
The return code is-8. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3,4, 13, 20, and 29. 
If itis a COPY or DUMP, 36a and 36b. 


ADR429W = (xxxmmmmm(yy), DATA SET dsname WAS 
RESTORED TO AN SMS-MANAGED 
VOLUME BUT IT WAS NOT CATALOGED 
BECAUSE THE CATALOG KEYWORD WAS _ 
NOT SPECIFIED 

Explanation: The named non-VSAM data set was restored to 

an SMS-managed volume. Because the catalog keyword was 

not specified on the RESTORE command, DFDSS did not 

catalog the data set when it was restored. 

System Action: The data set is restored. The return code is 4. 

Programmer Response: You must catalog the data set before it 

can be accessed because it is now under SMS management. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3,4, 13, 20, and 29. 


ADR430E (xXX}mmmmm(vy), ERROR IN CLUSTER 
clustername IN CATALOG catname ON 
VOLUME volser 

Explanation: A failure occurred during definition of the cluster 
components in the VV DS or VTOC during a data set COPY 
or RESTORE. 

System Action: The data set is not processed. The return code 
is 8, 

Programmer Response: Run Access Method Services 
DIAGNOSE on the data set on the volume, and take the 
appropriate action berore rerunning the job to process the data 
set, 

Operator Response: None. 

Problem Determination: Table I, items 1, 2,3, 4, 13, 20, 25a, 
23D, 29, 36a, and 360. 





ADR431I (xxx-}mmmmm(yy), DATA SET dsname [IN 
CATALOG catname] HAS BEEN DELETED 
Explanation: The data set was deleted on user request. 
System Action: The data set was deleted from the volume. 
Programmer Response: If the data set was cataloged, it must 
be uncataloged by using other utilities. 

Operator Response: None. 

Problem Determination: Table [, items 1, 2, 3, 4, 13, 20, 25a, 
250, and 29. 


ADR432E (xxx}mmmmm(yy), VVR FOR COMPONENT 
componentname [IN CATALOG catname] IS IN 
ERROR 

Explanation: A data set cell, AMDSB cell, or volume cell 
cannot be located in the VVR for the component in the VVDS 
or VVDS image ‘input to data set RESTORE). The format of 
the VVR may 2e :n error. 

System Action: The data set to which the component belongs 
is not processed. Other messages indicating the affected cluster 
that is not processed accompany this message. The return code 
is 8. 

Programmer Response: [f the failure ':s on a VVDS on DASD, 
run Access Method Services DIAGNOSE to determine the 
nature of the error, and take the recommended action. If it is 
the input to the RESTORE, use a previous backup copy to 
restore the data set. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 5, 13, 20, 29, 
36a, and 36b. 


ADR433E = (xxx}mmmmm(yy), LOGICAL ERROR IN 
BUFFER ON TRACK cchh 

Explanation: A ‘ogical error was discovered in the track data 
after it had been read into the buffer and before writing it to 
DASD. The length of the track data does not match the sum 
of the count, key, and data fields of all records on the track in 
the buffer. This prociem can arise if tne track was not 
reconstructed correctly by DFDSS during the RESTORE or if 
the track was not written-correctly during the DUMP or, 
similarly, during a COPY. 

System Action: The track is not processed. The return code is 
8. 

Programmer Response: Contact IBM to correct the problem. 
Operator Response: None. 

Problem Determination: Table [, items !, 3,4, 350, 13, 20, and 
29, 


ADR434E (xxx}mmmmm(yy), DATA SET dsname [IN 
CATALOG catname. WAS NOT 
UNCATALOGED, re 


Explanation: Tre data set was not uncataloged for one of the 
following reason codes {rc}: 


0 Itisa VSAM{ cata set. (DFDSS coes not support 
UNCATALOG for VSAM.) 


1 I/O or other errors, such as authorization or enqueue 


failure, occurred on the data set, or no catalog entry was 
found for the data set. 

2 Either the data set ‘s not a singie-volume data set, or it 
cannot be cstermined if the data set is singie volume or 
muitivoiume and itis not presenty cataloged. 


3. The data se. was not enqueuec oy DFDSS. 


4 The data se. was not processed. [: is probably a null data 
set 


5 {tts an SMS-managed data set. UNCATALOG is ignored 


System Action: Processing continues. The return code is 8. 
Programmer Response: Uncatalog the data set by other 
means. 

Operator Response: None. 

Problem Determination: Table [, items 1, 2,3, 4, 13, 20, 25a, 
and 29. 
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ADR435E (xxx}mmmmnm(yy), DATA SET dsname WAS 
NOT CATALOGED 

Explanation: The data set was not cataloged because either the 
data set is not a single-volume data set, or it cannot be 
determined whether the data set is a single-volume or 
multivolume data set. 

System Action: Processing continues. The return code is 8. 
Programmer Response: Catalog the data set by other means. 
Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, 25a, 
and 29. 


ADR436E (xxx}-mmmmm(yy), LOGICAL ERROR IN 
BUFFER ON VOLUME volser, TRACK cchh 
Explanation: A logical error was found in the track data after 
it had been read into the buffer and before writing it to tape. 
System Action: The track is not processed. The command is 
ended. The return code is 8. 

Programmer Response: Contact [BM to correct the problem. 
Operator Response: None. 

Problem Determination: Table [, items 1, 3, 4, 5b, 13, 20, and 


29. 


ADR437E (xxx}>mmmmm(yy), CLUSTER clustername [IN 
CATALOG catname] CANNOT BE {OPENED 
| CLOSED} retcode rsncode 

Explanation: The specified cluster cannot be opened or closed 
for VSAM I/O processing. VSAM responded with a return — 
code and a reason code after processing had failed. 

System Action: The indicated data set is not restored. The 
return code is 8. 

Programmer Response: Use your VSAM Administration: 
Macro Instruction Reference to identify the problems indicated 
by the return code and the reason code. Take corrective 
actions, and rerun the job. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR438E (xxx+}mmmmm(yy}), VSAM 1/O FAILED FOR 
cluster retcode rsncode 

Explanation: VSAM [I/O processing failed for the specified 
cluster name. VSAM provided a return code and a reason code 
after processing nac railed. 

System Action: The indicated data set is not restored. The 
return code is 8. 

Programmer Response: Use your VSAM Administration: 
Macro Instruction Reference to identify the problems indicated 
by the return code and the reason code. Take corrective 
actions, then rerun the job. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3,4, 13, 20, and 29. 


ADR439E (xxx}mmmmm(yy), PREALLOCATED DATA 
SET dsname WAS SELECTED BUT IS NOT 
USABLE, re 

Explanation: DFDSS found a preallocated data set but 


determined that it was unusable for the following reason (rc): 


04 The preallocated cluster type is not equal to the target 
cluster type. 


08 An AIX is defined over the preallocated cluster. 


12 The source data RECORDSIZE is incompatible with the 
target CISIZE and/or control area size attributes. 


16 The preallocated target relative key position and/or key 
length is not equal to the source cluster values. 
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20 The preallocated xeyed VSAM cluster is not empty or 
REUSABLE. 


24 The preallocated KSDS KEYRANGES do not match those 
of the source cluster. 


28 The index component of the e pr reallocaied target cluster 
does not Adve satlcient alc ace for the source 
index component. 


32 At least one data component of the preallocated target 
cluster does not have sufficient allocated space for the 


corresponding source data component. 


40 At least one comsonent 
spans volumes. 


of the prealiocated target cluster 


44 An update of the target VTOC entry failed. The target 
must be updatec :o make the target data set look empty if 
a utility will do tne data transfer. 


48 The VSAM daza set must be copied or restored with 
utilities, which requires that both the source and the target 
data sets ce cata.oged in tne standard order of search, 
However, because they both have the same name, this is 
not possible. 


52 The preallocated, unmovable data set is not on the same or 
a like device type as the source data set. 


36 The preailocated DSORG is not equa! to the target 
ISORG. 
60 The preallocated data set space is insufficient. 


64 The preallocated PDS has an insufficient number of 
directory blocks to contain the source directory. 


68 The preallocatec cata set cnecking could not be completed. 


72 The oreallocated cata set extents do not match the source 
: : z cata set. 


ela, ap ai's Ane ae its : aw: 
one SOULCS 18 ATL LN Movadie 


76 Tre BDAM cain set cannot be creallocated to an unlike 
device tyce. 
80 The crealiccate2 cata set nas no SUL extent. 


84 The orealioc2: 


88 An [/O error 





92 Vhe daia set ce.ng restored 's a PDS with no directory 
olocks and cannot be restored to a creailocated data set. 


96 The preallocatec 
100 


match the source sphere. 


The orealloca: u 
dlock size is greater than the t 


{04 Th 


>ecause the source 


pacity. 


i Widig. BR ee ee 
vice track ca 


the preallocated 
asthe HURPN to 


alec target data set to 





108 The hign-used t2g2 value /HURPN®* of 





Yr 


System Action: Tr: 


toptara sets 


oO Cala 


t 
7) 
a 
io) 


nel processed. The 
return code is 8. 

Programmer Response: If use of a prea.located data set is not 
required and: zn ane output volume is specified, rerun 
the Job without soecirey REPLACE. If use of the 
preallocated data se: .s required, correct tne problem as 
indicated by the reason code fre), and rerun the job. 


miore i7 





O04 Delete and recetine the target clu 
cluster types ar¢ ine same. 


ster, ensuring that tne 


08 Delete any AIX and PATH! associations defined over the 
target ciuster. 
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12 


16 


20 


24 


28 


32 


40 


44 


48 
52 


64 


68 


72 


80 
84 


88 


co ws «k wots 


Delete and redefine the target cluster using the source 
cluster RECORDSIZE attributes. 


Either delete and redefine the target cluster using the 
source cluster KEY attributes, or ALTER the target cluster 
KEY attributes to equal the source. 


Delete and redefine the target cluster. If the target is to be 
copied to repeatedly anc is not a key range cluster, specify 
the REUSE attribute on the DEFINE. 


Delete and redefine the target cluster, ensuring that the 
KEYRANGES(lowkey highkey) for target cluster are equal 
to the KEYRANGESUowkey highkey) for the source 
cluster. 


Delete and redefine the target cluster with at least as much 
primary index space as the source index has, or force the 
target cluster index te extend to at least as much space as 
the source index. 


Delete and redefine the target cluster with at least as much 
primary data space as the largest source data component, 
or force the target cluster data components to extend to at 
least as much space as the source data components. 


Delete and redefine the target cluster, ensuring that no 
components span vclumes (CANDIDATE volumes Ls 
excepted). 


One of the following actions should be taken: delete the 
target and rerun DFDSS, allowing it to perform the 


' allocation; delete the existing target and reallocate a new 


one, leaving itempty; or use AMASPZAP to alter the 
target data set VTOC entry to make the data set appear 
empty. 


Do not preallocate the data set. 


Allocate an unmovatie target data set on the same or a 
ry the FORCE keyword. 





d DSORG Is equal to the sourc 


that the amount of space allocated for the 
ted dala sei is sufficient to contain the source data 





Ensure that the numer of directory blocks defined for the 
prea.ccaied PDS :s suficient to contain the source 
directory blocks. 


Refer to the previous DFDSS message for the probable 


reason. 


Ensure that the prea..ccated data set extents match the 
source data set extents 


Ensure inat the REBLOCKADDRESS kKevword was 
soecitied and that tne source: 
* f3 not a stancarc user label data set 


: rixed or fixed block. 
Or scraich and reaiiccate the target on the same device as 
the source or on a 2x2 device. 

Allocate a preailocatec data set with standard user labels. 


e@ a standard user label data set with more than just 


Allocat 
the standard user ‘ate: extent. 


Scratch and reallocgte the target partitioned data set to 
either a different location on the target volume or a 
different target volume. 


the target Caza set and ailow DFDSS to allocate it 
restore oceration. 


Scratch 
during the 


96 Ensure that the preallocated sphere’s AIX names, number 
of AIXs, number of paths, and path names match the 
source sphere’s AIX names, number of AIXs, number of 
paths, and path names. 


100 Either reblock the data set or specify a target device that is 
large enough fer the source block size. 


104 Delete and reallocate the target partitioned data set on a 
like device, or rerun the job without specifying 
NOPACKING for the data set. 


108 Ensure that the preaiiocated PDSE is usable and accessible. 


Operator Response: None. 





Problem Determination: Table I, items 1, 3, 4, 13, 20, 25b, 25c, 
and 29. 
ADR440E (Xxx>mmmmm(yy), UNEXPECTED RETURN 


CODE FROM externainame: xxx-yyy, WHILE 

PROCESSING DATA SET dsname 
Explanation: In processing the specified data set, the named 
external routine was caiied, and it returned an unexpected 
return and/or reason code. 
System Action: Processing is ended for the specified data set. 
The return coae is 8. 
Programmer Response: This message is not normally expected 
and indicates a srogramming or system problem. Rerun the 
job with PARM: ='ABEND=440' on the EXEC statement, 
ang aSYSUDUMP DD statement. Contact {BM for 
programming support. . : 
Operator Response: None. 
Problem Determination: Table I, items 1, 3,4, 13, 20, and 29. 


ADR441W ) (xxx>mmmmm(yy), LOGICAL ERROR IN 
BUFFER ON TRACK echh 
Explanation: A. logical 2r72r was discovered in the track data 
Lite Coe SEler ead perars Ae iL to 


ftune track data does not match the sum 
records on the track in 


i daca “elds of 2 
I Caw «ibis OF 





“buffer. thes 


e sage ‘s issued instead of ADR433E when 
ee CELERROR is no. srecifed. 
em Action: “tap sPacx 3 Mot precessed; ‘The-return cade ts 


hoa fe 


es DFDSS PRINT to examine the 
tne problem if unabdie to 


Programmer Response: 
Wracx cata, Ceoniaci IBN 


Getermine the cause. 


A Aner? 
20 SOrrece 


Operator Response: None. 

Problem Determination: Table [, items 1, 3, 4, 5b, 13, 20, and 
29. 

ADR 442] (xXxX>mmmmmi(vy), DATA SET dsname 


PREALLOCATED [, IN CATALOG catname], 
ON VOLUVIE(S): {solser | volser list} 





Explanation: Tre data set was selected for replacement as a 
prea located target data set. The target cataiog name, if 
ROOMS, 1S Oris The target volume or optional volume list is 
aiwavs printed with this message. 

System Action: \ one. 

Programmer Response: None. 

Operator Response: Nore. 


Problem Determination: Tarle [, items 1, 3,4, 13, 20, and 29. 


“ADR440E — ADR444E 


ADR443W = (xxx+mmmmm(yy), DUE TO ERRORS, 
TARGET COMPONENT name [IS NOW 
NAMED name. CLUSTER cluster name, 
CATALOG catname 

Explanation: During COPY processing, the target cluster and 


components can ce allocated using generated names. After the 
COPY, the target cluster name and component names are 
altered to match the source names. This message indicates that 
the target cluster name was successfully altered, but the alter 
for a component failed. 

System Action: Processing continues with the next data set. 
Message ADR469W follows this message. The return code is 4. 
Run Access Method Services LISTCAT against the target 
catalog to determine the reason for the Access Method Services 
ALTER failure. You can alter the component name to match 
the source by using Access Method Services ALTER 
NEWNAME. 
Operator Response: 
Problem Determination: 


None. 
Table I, items 1, 2, 3, 4, 13, 20, 26, 


and 29. 

ADR444E (xxx+}mmmmm(yy), DATA SET dsname { [S 

F EMPTY | HAS AN UNSUPPORTED 
DSORG}. IT WILL NOT BE COPIED 

Explanation: The data set cannot be copied to an unlike device 


for one of the following reasons: 
* It has an unsupported DSORG. . 
e It has a BLKSIZE of 0. 


¢ Itis empty (DSILSTAR = 
as its first record. 


0) but does not have an EOF 


The data set cannot de copied to a like device if it is Doth 


* Empty and is teing reblocked, and 


Ua 


* Its first record is not an EOF record. 


System Action: The data set was not copied. Processing 
continues. The return code ts 8. 

Programmer Response: To nave the data set 
the following: 


opied, do one of 


¢ For a data set with an unsupported DSORG, maxe sure 
that the selectec target volume ts of a like device type. For 
a Gata set with an unsupported DSORG going to an unlike 
target device, specify the PROCESS keyword with the 
UNDEFINED subkeyword. The target device specified or 
chosen must have a track capacity equal to or greater than 
the source. 


aa Pasaan = ), make sure that the 
ike device tvoe, 


* Fora cata set wit 

selected target volume is of a! 
ty cata set, use ALLDATA or ALLEXCP to 
sy of all allocated space in the data set. Make sure 
aa the selected tar get volume is of a like device type and 
the data set is not being rebiocxed. 


None. 
Table I, items i, 2, 3, 4, 


Operator Response: 
Problem Determination: 
and 29. 


13, 20, 25a, 
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- ADR4451 — ADR45ZE 


ADR445I (xxx>}mmmmm(yy), SOURCE VSAM DATA 
SET dsname [IN CATALOG catname] IS 
EMPTY 

Explanation: The source VSAM data set is empty; therefore 
the target data set is allocated, but no data movement is 
performed. If the data set is preallocatsd. the existing data set 
is Geleted then reailocated using the scurce as the modei. 
System Action: Processing continues. Tie return code is 0. 
Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR446E (xxx>mmmmm(yy), DATA SET dsname [IN 
CATALOG catname] CONTAINS NO 
DIRECTORY BLOCKS 

Explanation: A partitioned data set witn no directory was 
encountered. This was caused by not specifying at least one 
directory block at the time the data set ‘was created. 

System Action: The data set is not precessed. The return code 
is 8, 

Programmer Response: None. 

Operator Response: None. 


Problem Determination: Table I, items 2, 3,4, 13, 20, and 29. 


ADR4471I (xxx>mmmmni(yy), VSAM DATA SET dsname 
[IN CATALOG catname’ WAS DELETED 
FROM VOLUMIE volser, re 

Explanation: The target VSAM data set was deleted. The - 


reason codes (rc) are: 


1 The target KSDS/VRRDS on an unlike device was not 
reusable. 

2 The data set organization of the target did not match 
tne source. 

3 Tre CI size of the targe: did no. match the source. 

4 Tre IMBED attribute of the tarz=t did not match the 
source. 

3 Tre KEY cenzth of tne target 2:2 not match the source, 

6 Tne recore ‘ength of ine target 2.2 nol match the 
source. 

7 Tae REPLICATE attr:sute of ine carget did not match 


tne source. 


8 The SPANNED attrioute of the target did not match 
the source. 


B The source cata set is empty. 


System Action: Processing continues. For reason codes 2 and 
4 


4 to 8. the source attributes override tose of the preallocated 
target. The return code is 0. 
Programmer Response: None. 
Operator Response: None. 
Problem Determination: Nonxe. 


ADR4481 (Xxx-mmmmm(yy), DATA SET dsname 
DUMPED USING NON-OPTIMIZE 
CHANNEL PROGRAMS AFTER TRACK 
OVERFLOW RECORDS WERE 
ENCOUNTERED 

Explanation: The source data set conta.ned track overflow 
records and OPTIMIZE(2), (3), or (4) as specified for the 
dump. 

System Action: Tne source data set tracxs were processed by 
using monoptimized channel orograms. This results in 
performance degradation if the data se: :s not flagged as track 
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overflow in the VTOC entry or is not in the 
TRACKOVERFLOW keyword list. 

Programmer Response: No direct programmer action is 
required, because the data set was dumped successfully. 
Optimized channel programs fail on tracks containing overflow 
records, thus forcing a channel retry with nonoptimized channel 
programs in orcer to read the tracks. Therefore, data sets 
containing track overflow records that are not flagged as such 
in the VTOC entry must be prevented from using an optimized 
channel program. If ALLDATA or ALLEXCP is specified for 
the data set, and it does not contain any track overflow 

records, the allocated tracks beyond the end of the used data 
may have residual tracx overflow records that cause the 
message to be issued. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR4491 (xxx+}mmmmm(yy), MESSAGE DATA SET 
USED TO STORE TASK RELATED 
MESSAGES FOR THIS TASK IS FULL AND 
CANNOT BE EXTENDED FURTHER. 
MESSAGES WILL BE SPOOLED TO 
SYSPRINT. SUBSEQUENT MESSAGES 
FOR THIS TASK WILL BE STORED AND 
GROUPED TOGETHER 

Explanation: The message data set used to store messages for 
this task (in order to xeep messages grouped by task when 
DFDSS is running in parailel mode) has run out of space. All 
the messages stored thus far for this task are spooled to. oe 
SYSPRINT. If DFDSS is indeed running in parallel mode, this 
can cause the messages for this task to be broken into groups 
with messages from other tasks located in between them. 
System Action: The message data set is reinitialized, and 
messages continue to de stored and grouped together until the 
task ends or the message data set becomes full again. 
Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items !, 3,4, 13, 20, and 29. 


ADR4S50E (XxXX*¥mmmmm(yy), THE NUMBER OF INPUT 
AND OUTPUT TRACK RANGES DOES NOT 
MATCH 

Explanation: The numoer of input track ranges does not 
correspond to the numcer of output tracx ranges. Each input 
track range requires 2 corresponding output track range. Each 
output track range requires a corresponding inpul track range. 
System Action: The task is ended. The return code ts 8. 
Programmer Response: Specify the same number of input and 
output track ranges. 

Operator Response: None. 

Problem Determination: Tabie I, items 1, 3,4, 13, 20, and 29. 


ADR452E (xxx-mmmmm(yy), (IEHMOVE | IEBCOPY | 
IEBISAM | IDCAMS | ICKDSF} UTILITY 
FAILED WHILE PROCESSING {DATA SET 
dsname , VOLUME volser}, {ABEND | 
RETURN} CODE IS nan 

Explanation: During srocessing of a DFDSS function, a 
system utility was invoxed to process the specified data set. 
The utility encountered errors, and processing failed. 

System Action: The data set is not processed. The return code 
is 8. 

Programmer Response: Take one of the following actions: 


* For abending utiities, see the Sysrem Codes for an 
explanation of the abend code. If the abend is because of 
insufficient storage {DASD or virtual), you must run the 
utility itself (not through DFDSS), as described in your 
Utilities manual. {f IEHMOVE abends with code 0C4, it 


could be because DFDSS called it with a task I/O table 
(TIOT) referring to more DD statements than IEHMOVE 
can handle. In this case, change the DFDSS filtering to 
select fewer data sets. 


* For IEHMOVE, IEBCOPY, or [EBISAM error return 
codes, run the ‘ob by specifying the DFDSS 
UTILMSG = YES parameter. See the MVS/XA System 
Messages or MVS/370 Utilities Messages for an 
explanation of the utility messages. 


* For [DCAMS error return codes, run the job by specifying 
the DFDSS UTILMSG= YES parameter. See the System 
Messages for an explanation of the messages. 


* For ICKDSF error return codes, run the job and specify 
the DFDSS UTILMSG = YES parameter. See the Device 
Support Facilities User's Guide and Reference for an 
explanation of the messages. 


Operator Response: None. 
Problem Determination: Table I, items 1, 2, 3,4, 5, 13, 20, and 


29. 

ADR453E (Xxx}-mmmmm(yy), USER REBLOCK EXIT 
SPECIFIED AN INVALID BLOCK SIZE FOR 
DATA SET dsname. DATA SET WILL NOT 
BE PROCESSED 

Explanation: Tre data set was eligible for reblocking, and the 


user reblock exit was called. However, the block size returned 
to DFDSS from the exit was invalid for the data set. 

System Action: The data set is not allocated or copied. The 
return code is 8. 

Programmer Response: Correct the block size for the data set 
in the exil routine. 

Operator Response: None. 


Problem Determination: Tacie [, items :, 2,3, 4, 13, 20, and 





29. 

ADR4S541 (XxX}mmmmm(yy), THE FOLLOWING DATA 
SETS WERE SUCCESSFULLY PROCESSED 

Explanation: T2 ‘ist or successfully crocessed data sets 

follows ze 

System Action: Processing continues 


Programmer Response: None. 
Operator Response: None. 
Problem Determination: None. 


ADR455W  (XXx-mmmmm(yy), THE FOLLOWING DATA 
SETS WERE NOT SUCCESSFULLY 
PROCESSED 

Explanation: [ne list of data sets that were not successfully 

processed fronows This message. 


System Action: Processing continues. The return code is set to 


ra 

Programmer Response: None. 
Operator Response: None. 
Problem Determination: None. 


ADR456I (XxxX}-mmmmm(yy) THE NUMBER OF DATA 
SETS PROCESSED ON VOLUME volser IS 
nnnnn 

Explanation: The number, nnnnn, is the number of data sets 
successtully processed. For COMPRESS, the data set names 
follow this message. 

System Action: Processing continues. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR453E — ADR461W ©: : 


ADR457I (xXxx}>mmmmm(yy), THE NUMBER OF 
TRACKS MADE AVAILABLE ON VOLUME 
volser [S nnnnn 

Explanation: RELEASE processing released nnnnn tracks. 
System Action: Processing continues. 

Programmer Response: None. 

Operator Response: None. 


Problem Determination: None. 





ADR4581 (xxx+>mmmmm(yy), (TOTAL | USED} 
NUMBER OF TRACKS ON VOLUME volser 
IS nnonnn 

Explanation: The number, nnnnn, indicates either the total 
number of tracks on the volume or the number of used tracks 
on the volume after RELEASE processing. 

System Action: Processing continues. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR459E (xxx}+}mmmmm(yy), ERROR ENCOUNTERED 


WHILE FILTERING ON THE CATALOG. 


_ Explanation: This message is preceded by message ADR497E 


or ADR724E. When this message is preceded by ADR497E, 
refer to {[DC3009I in System Messages for an explanation and 
corrective action. When preceded by ADR724E, refer to 
IGWO1zzz in System Messages for an explanation and 
corrective action. 

System Action: The current volume is bypassed. Processing 
continues with the next volume, if any. The return code is 8. 
Programmer Response: For I/O errors, follow 
recommendations by your instailation for [/O errors, and 
resubmit the job. For logical errors encountered in the VVDS, 
run Access Method Services DIAGNOSE against the indicated 
volume, anc take necessary action to correct the problem. 
Operator Response: Sane. 

Problem Determination: Taoie I, items !, 2, 3, 4, 5b, 13, 20, 
25b, and 29. [f it is a logical error, use the PRINT command 
to print ine VTOC and VV DS tracks before taking action 29. 


ADR4601 (XXxX+mmmmm(yy), UTILITY GENERATED 
MESSAGES FOLLOW FOR {DATA SET 
dsname | VOLUME volser} 

Explanation: During processing of a DFDSS function, a 
system utility was invoked that generated SYSPRINT data. 
The utility messages are printed following this message when 
UTILMSG = YES is specified in the PARM information of the 
DFDSS EXEC statement. 

System Action: The function continues processing. 
Programmer Response: None. 

Operator Response: Nore. 

Problem Determination: None. 


ADR461W  (xxx}mmmmm(yy), UNMIOVABLE DATA SET 
dsname WITH FOLLOWING EXTENTS 
CANNOT BE PROCESSED 

Explanation: The unmovabie data set that has the listed 
extents cannot be processed. Either the system does not 
support ailccation of unmovable data sets or the extents are 
not free on the target volume. 

System Action: The data set is not processed. The return code 
is set to 4. 

Programmer Response: Either specify FORCE if you want to 
move the unmovable data set, or free the required extents and 
rerun the :0b. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 25a, and 29. 
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ADR462E — ADR468E 


supe eS stenNicn Sy Breda tg, Age deeb tans Gee LSS aes hy SNe eal oe OP a ae 


ADR462E (xxx}>mmmmm(yy), NON-VSAM DATA SET 
dsname [IN CATALOG catname] IS NOT 
PROCESSABLE 

Explanation: The CVOL catalog entry is not processed 
because the DELETE subparameter was not specified and the 
RENAMEUNCONDITIONAL subparameter was specified. 
System Action: Processing continues. The return code is 8. 
Programmer Response: Copy the CVOL catalog, specifying 
DELETE, and remove the RENAMEUNCONDITIONAL 
subparameter. 

Operator Response: None. 


Probiem Determination: Table 1, items 1, 3,4, 13, 20, and 29. 


ADR463E (xxx}mmmmm(yy), CLUSTER clustername WAS 
NOT {DELETED|DEFINED|ALLOCATED} 
BECAUSE VOLUME(S) WERE NOT 
AVAILABLE 

Explanation: The allocation of the volumes failed because the 
volumes are not available. The cluster was not deleted, defined, 
or allocated. 

System Action: The return code is 8. 

Programmer Response: Ensure that the volumes where the 
cluster resides are available. 

-Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


(Xxx->}mmmmm(yy), DATA SET dsname HAS 


ADR464I 

eo BEEN UNCATALOGED FROM CATALOG 
catname 

Explanation: The named data set was uncataloged at the user’s 

request. 

System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR4651 (xXx+}mmmmm(yy), DATA SET dsname HAS 
BEEN CATALOGED IN CATALOG catname 
Explanation: Tre named cata set was caiaioged at the user’s 
request. 

System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR466E {(xxx}mmmmm(yy), UNEXPECTED RETURN 
CODE nn FROM PARTREL MACRO IN 
NIODULE modname WHILE PROCESSING 
DATA SET dsname 

Explanation: A PARTREL macro was ‘ssued to release all 
unuseé DASD space from 2 sequentiai or partitioned data set, 
and an unexpected return code was received during RELEASE 
prevessing. A return code or 8 indicates tnat a data set was 
open. Amy other return code probabiy incicates an invalid 
VTOC. 

System Action: Processing of the command is ended. The 
return code is 8. 

Programmer Response: See the System-Data Administration 
for an explanation of PARTREL return codes. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3,4, 13, 20, 25a, 25b, 
and 29. 
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ADR467E (xxxX}+mmmmm(yy), DURING A TARGET 
TRACKS COPY, THE OUTPUT TRACKS 
FALL WITHIN THE INPUT TRACK RANGE; 
AND THE INPUT AND OUTPUT VOLUMES 
ARE THE SAME 

Explanation: A COPY request was issued with the 
OUTTRACKS option. The input volume serial number and 
output volume serial number are the same, and the eutpHt 
tracks overlap the input tracks. - ; 
System Action: Processing of the command is ended. The 
return code is 8. 

Programmer Response: Select nonoverlapping tracks for input 
and output. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3,4, 13, 20, 25a, 
and 29. 





ADR468E (xxx}+-mmmmm(yy), VSAM DATA SET dsname 
{IN CATALOG catname] IS NOT 
PROCESSABLE 

Explanation: The VSAM entry was not processed because one 


or more of the following conditions exist: 


¢ If REPLACE was specified, either the data set does not 
qualify for preallocation or a preallocated target does not 
exist, and one of the following conditions applies: 


- If DELETE is specified and the entry name is a SYS1., 
page, or swap data set, the RENAMEU subparameter 
was not specified. 


— If the entry name is a cluster name and DELETE was 
not specified, then: (1) the RENAMEU subparameter 
was not specified, or (2) the RECAT subparameter was 
not specified. 


— [Fthe entry name is an alternate index or a user 


c412. og name: ‘t) the DELETE subdparameter was not 
scecified, or (2) the RENAMEDU subparameter was 
Sine 


* [fF REPLACE was not specified, one of the following 
seat teak applies 


-— 1? DELETE is specified and the entry name is a SYS1., 
Daze, or swad cata set, tne RENAMEU sutparameter 
was MOL specified. 


— [Ifthe entry name is a cluster name and DELETE was 
not specified: (1) the RENAMEU subparameter was 
net specified or (2) the RECAT subparameter was not 
scecified. 


ntry name is an alternate index or a user 


\) the DELETE subparameter was not 
ted or (2) the RENAMEDL subparameter was 


~- [fine entry name is 4 user calaiog name, 
INDDNAME or INDYNAM was specified. 


System Action: Processing continues. The return code is 8. 


Programmer Response: Take one of the following actions: 


« [f REPLACE was specified: 


Ir the data set ts eligible for preallocation, ensure that a 
qualifying target is available on the target volumes. 


~ If the data set is not eligible for preallocation or a 
REPLACE operation is not required, then determine 
rarther action from the following lists. 


¢ Ifthe entry name is aSYSI., page, or swap data set and 
DELETE is specified, copy the entry specifying 
REN AMEU(newname). 


a vs beans SP ge Bog Se 


° If the entry name is a cluster name: (1) copy the cluster by 


specifying DELETE or (2) copy the cluster by specifying 
RENAMEU(newname) or (3) copy the cluster by 
specifying RECAT(catname). 


° Ifthe entry name is an alternate index or a user catalog 
name, COC) ine aternate index or user catalog, srecifying 
DELETE, aad remove the RENAMEU subparameter. 


° If the entry name is a user catalog name, do not specify 
INDDNAME or INDYNAM. 


Operator Response: None. 
Problem Determination: Table [, items 1, 3, 4, 13, 20, and 29. 





ADR469W ss (xxx}mmmmm(yy), THE FOLLOWING DATA 
SETS WERE COPIED, BUT ENCOUNTERED 
POSTPROCESSING ERRORS 

Explanation: After a data set was copied, a postprocessing 

error was encountered. The error occurred during an attempt 

to catalog, uncatalog, scratch, correct 2 VSAM cluster 
component name, or RACF/password-protect the source or 
target data set. 

System Action: Processing continues. The return code is 4. 


Programmer Response: See earlier messages for specific errors. 


Operator Response: None. 
Problem Determination: Table I, items 1, 2,3, 4, 13, 20, and 
29. 


ADR470W = (xxx}mmmmm(yy), NO DATA SETS 
SELECTED FOR COPY 

Explanation: No data sets were selected for processing. The 

data sets found in the catalog or on the input volumes did not 

pass INCLUDE, EXCLUDE, or BY filtering or cannot be 

copied. 


System Action: Process: nues with the next control 





Scatermes. Tee sees: 

Beoe! ammrieny: Re sponse: \\nen input voiumes are specified, 
ensure tnat pease saa Se a cluster and ail pieces of a 
sutivaliene: Gata set are contained on the input volumes. 


riter ss criteria, i a STEPCAT, or speciry differen: 
‘HOUL sOCumes, Tres rercn se 10b. 

Operator Response: Nore. 

Problem Determination: Tadle I, items 1, 3,4, 13, 20, and 29. 





ADRATIE (xXX-mmmmm(yy), DUE TO ERRORS, 


SOURCE (CLUSTER: COMPONENT} name IS 


NOW NAMED name. CLUSTER clustername, 
CATALOG catname 
Explanation: During COPY process:n 


* 

co 
~ 
ww 


, the source cluster and 
a 


ws Foy onl iS Pelayo ages ate ge aia he 
VITO ASRS Car Sere ra 3s In orce: 







es source name. I[f the target- 2 
is deletec, and restoring tne source 
s attemctec. This message is suas 
The cluster name and cata! 
me anc iocation cf the failing cata set. 
Sys tem Action: Processing continues with the next data set. 
Messaze ADR= SSE | follows this message. The return code is 8. 
Programmer Response: Run Access Method Services 
DIAGNOSE aza:nst the source and target catalogs to 
determine the reason for the Access Method Services ALTER 
failures. Restore ine origina: cluster name, using Access 
Method Services ALTER NEWNAME. 
Operator Response: None. 
Problem Determination: Taole I, items 1, 2,3, 4, 13, 20, 26, 
29, and 3a. 





allow the COPY targe: 


~ADR469W — ADR472E 


ADR472E = (xxx}>mmmmm(yy), UNABLE TO SELECT A 
TARGET VOLUME FOR DATA SET dsname 
(IN CATALOG catname], rc 

Explanation: DFDSS was unable to select a target volume 

from the available target volumes for one of the following 

reasons {rc). 


04 No target volume has enough a to accommodate the 
target data set. 


08 At least one duplicate data set was encountered on a target 
voiume, and the REPLACE keyword was not specified. If 
the duplicate data set is named SYSi.xxxx, you must also 
specify PROCESS(SYS1). However, DFDSS will not 
replace a SYS1.xxxx data set that is a CVOL, Integrated 
Catalog Facility user catalog, VVDS, or VTOCIX, 
regardless of the REPLACE and PROCESS(SYS1) 
keywords. 


If the target volume did not contain a duplicate data set, 
then this reason code means the target volume did not have 
enough space for the data set. For an ISAM data set, the 
matching space in the target volume was not available. 


12 The data set is non-VSAM and is allocated as either 
unmovable or absolute track. DFDSS was able to select 
only unlike targets for target allocation and the FORCE 
xeyword was not specified. 


16 The data set is non-VSAM and either unmovable or 
absolute track allocated. An absolute allocation failure, or 
iack of system support for absolute allocation, precludes 
the use of absolute allocation; however, the FORCE 
keyword was not specified. 

20 A directory read failed for the partitioned data set. 

24 An error was encountered while tne VSWR records for the 
VSAM data set «ere Deing reac. 

28 Duricate VTOC entries were encountered on the only or 
ail availabie target volumes for the VSAM Gata set. 


Por the VSAM Gata set was encountered 
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36 An error was encountered during ine cefine of the tarzet 
VSAM data set. 


40 GETMAIN errors were encounterec while the interna! 
control blocks for the data set were teing built. 


44 The data set was a direct access (BDAM) data set, and 
only target dev: ces of smaller track capacity than the 
source were available. The data set as not specified tn 
the REL BLOCK ADDRESS Xeyword list, or it was 
scecitied in RE Peiaicih cemcas Sut the data set is 
accessed OY re.auve dloex address i.e... ‘ 


S 
user iabel or its record formatis net F or FB:. 


cw 
¢ 
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DFDSS does noi allocate or attemct to Copy the data set. 


48 The source data set block size was zrea 
capac aii voiumes DFDSS was 22! 
auocation. The data set was not incicat 
overflow in the VTOC entry 





7) 
nw 


An indexed VTOC was not availabie. 


Not enough space is available in the VTOC on the target 
volume. 


mn 
[on 


60 The DADSM installation exit rejected the allocation 
request. 


64. No output volume was specified for tne COPY function, 
and the data set is not SMS managed. 


Chapter 2. System DF DSS Messages 47 


eres er er ee 


ADR473E — ADR474I 


RE See OTTER ores Ae ee etl a, be 


68 Usable space on all the target volumes combined was 
insufficient to define the target data set. 


72 During a non-SMS allocation, no target volumes were 
available and at least one output volume was not selected 
because it was SMS managed. 


76 The NOPACKING keyword was specified for the data set, 
bul no space was available or no like devices were specified 
as targets. 


80 No target volume that has device track capacity equal to 
Or greater than the source is available for selection. 


84 The data set was a direct access (BDAM) data set and the 
only available target devices were unable to contain the 
source track’s worth of data due to the blocksize of the 
data set. For example, if the source device is a D/T3380 
and the only available devices are D/T3390S, and the data 
set’s blocksize is 190 with a xey length of 0, then a track 
on the target cannot contain as much Cata as a track on 
the source, 


The data set was not specified in the 
RELBLOCKADDRESS keyword list, or it was specified in 
the REBLOCKADDRESS but it was not accessed by a 
relative block address (i.e., it has a standard user label or. 
it’s record format is not F or FB). DFDSS does not 
allocate or attempt to copy the data set. 


88 During a non-SMS allocation, no usao.e target volumes 
were available. 


92 During DFDSS data set COPY, an attempt was made to 
copy the data set back to its source volume with DELETE 
specified, but neither RENAME nor 
RENAMEUNCONDITIONAL was specified. 


System Action: The data set is not copied. The return code is 
8. 

Programmer Response: Depend:ng on tre 72ason code, take 
the following action and rerun tne job: 


04 Either increase the value for PERCENTUTILIZED, or 
Speciry additicna. target vc.umes. 


08 Specify additiona: target volumes, deie:e the duplicate data 
set, specify REPLACE, or scecify PROCESS(SYS1). For 
ISAM data sets. specify a volume that mas free space on 


the matching tracxs. 


12 Either specify FORCE if the unlike tarzet volumes are 
desired, or specify additional target voiumes of the same 
device type that the data set currently resides on. 

16 Specify FORCE or specify additiona! target volumes. 

20 Ensure that tne oartitionec cata set ‘s usable. 

24 Ensure that the cluster anc :ts components are usable. | 

28 Specify additiona. target voiumes. 

32 Ifa target cataicg was specified by using RECATALOG, 
either delete the existing data set in that catalog, or specify 
a different cataiog. If a target catalog was not specified, 
the data set :s ceing definec in a cata.cg set by the 
STEPCAT/JOBCAT/MASTERCAT structure. Either 
determine where the duplicate entry ex:sts and delete it, or 
modify the catalog structure using a STEPCAT statement 
in the job JCL. 


36 Message ADR497E accompanies this message. Determine 
the cause of the error and correct it. 


40 Increase the region size. 


44 Specify target devices of the same or iarger track capacity 
for the direct access (BDAM) data set. 
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Operator Response: 
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48 Specify target devices of the same or larger track capacity 
for the data set, or use an appropriate system utility to 
copy the data set. 


52 Specify a volume with an indexed VTOC. 


S6 Enlarge the VTOC on the target volume or specify 
additional target volumes. 


60 Specify additional target volumes. 
64 Specify OUTDDNAME or OUTDYNAM. 


68 Either specify additional target volumes or, if 
PERCENTUTILIZED was specified, increase the 
PERCENTUTILIZED value. 


72 Specify non-SMS-managed volumes in the OUTDD or 
OUTDYN. 


76 Either rerun the job without specifying NOPACKING for 
the data set, or rerun the job specifying the same or like 
devices with enough room to allocate the data set. 


80 If the target data set is SMS, make sure that the storage 
class selected maps to a storage group that has devices 
with track capacity equal to or greater than the source. If 
the target data set is non-SMS, specify a target volume 
that has track capacity equal to or greater than the source. 


84 Specify target devices of the same or larger track capacity 
for the direct access (BDAM) data set. 


88 Specify usable non-SMS target volumes in the OUTDD or > 
OUTDYN statement. 


92 Choose a target volume different from the data set’s source 
volumes, or use the RENAMEU keyword to rename the 
data set. 


None. 
Table I, items |, 2, 3,4, 13, 20, 28b, 


Operator Response: 
Problem Determination: 
26, and 29. 


ADR473E (XxxX}+>mmmmm(yy), FAILURE WHILE 
ATTACHING UTILITY MODULE, RC =xx 
Explanation: DFDSS was unable to attach a utliity module. 
The reason codes, xx, are documented in the Application 
Development Guide 

System Action: No data sets are processed, The task ended. 
Processing continues with the next control statement. The 
return code is 8. 
Programmer Response: 
rcxx, and rerun the job. 
None. 

Table I, items 1,3, 4, 13, 20, and 29. 


Correct the problem as indicated by 


Problem Determination: 


ADR474I (xxx}mmmmm(yy), DATA SET dsname IS 
EMPTY, BUT IT WILL BE {COPIED 
IRESTORED} 

Explanation: 


During a COPY operation: 


* For an empty non-VSAM data set, the data set is 
allocated if the source data set has an EOF in its first 
record. Only an EOF record is written to the target 
data set. 


¢ For an empty VSAM data set, the data set is allocated 
but no data is copied. 


During a RESTORE operation: 
¢ The target data set is allocated but no data is restored. 


System Action: 
Programmer Response: 


Processing continues. The return code is 4. 
None. 
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Operator Response: None. 
Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, 25b, 
26, and 29. 


ADR@475I (xxx>mmmmm(yy), FOLLOWING DATA SETS 
WERE SELECTED 

Explanation: TYPRUN =NORUN was specified in the EXEC 
staternent parameter, and the following list of data set names 
met the filtering criteria. 

System Action: The data sets are not dumped, copied, or 
restored. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR476E (xxx+>mmmmm(yy), UTILITY PROCESSOR 
TERMINATED BECAUSE OF 
SYSPRINT/SYSIN PROCESSING FAILURES 

Explanation: Errors in uulity SYSPRINT or SYSIN data set 


processing occurred, causing the utility processor tasx to end, 
System Action: Utility processing is ended. The return code is 
8. 

Programmer Response: Rerun the job, ensuring that adequate 
DASD temporary space is available. 

Operator Response: None. 

Problem Determination: Table I, iterns 1, 2, 3, 4, 13, 20, and 
29. 


(XxxX-mmmmm(yy), VVDS/VVR/CELL 

ERRORS ENCOUNTERED FOR CLUSTER 

hame 

Explanation: Data set COPY or RESTORE encountered 

errors while reading or upcating VVDS/VVR/CELL 

information. 

System Action: The data 
rocessing continues. The return coce ts 8. 

Programmer Response: None. 

Operator Response: None 

Problem Determination: T2> 


ADR477E 


set is not cozied or restored. | 


fe [, items 1, 3,4, 13, 


ADR4I738W ) (xxx}mmmmm(yy), VSAM CLUSTER cluster 

name NOT DUMPED, COMPONENT 

component name SIZE [Ss GREATER THAN A 
SINGLE SOURCE VOLUME 

Explanation: The VSAM cluster was not dumped tecause it | 
had a multivolume compcnent that was larger than an entire 
source volume. To restore the data set, it would be necessary 

to a.locate the component on multiple volumes, but the system 
does not support the allocation of VSAM data sets on multiple 


System Action: The data set was not cumped. Processing 
contnues. The return coce ts 4, 
Programmer Response: Take one of 


* Use DFDSS DUMP, scecifying tne input volumes that 
contain the VSAM cluster. DFDSS RESTORE can restore 
the data set from the cump tape in physical dums format. 


* Use Access Method Services EXPORT to dump the VSAM 
ciuster. Use Access Method Services IMPORT to restore 


from the EXPORT-created dump ‘ape. 


tne following actions: 


Operator Response: None. 


ADR475I_ — ADR483W 
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Problem Determination: ‘Table I, items 1, 3, 4, 13, 20, and 29. 


ADR479E (xxx>mmmmm(yy), LOGICAL DATA SET 
DUMP TAPE DOES NOT CONTAIN 
{VSAM|NON-VSAM} DATA SETS 

Explanation: The requested type of data set is not on the 


logically formatted dump tape. Either the BY criterion is 
incorrect or the wrong tape was specified in the RESTORE 
command. * te 
System Action: No data sets are restored. Processing 
continues. The return code is 8. 

Programmer Response: Either change the BY criterion 
DSORG or use a different dump tape, and rerun the job. For 
an empty VSAM data set, no action is required. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR480W = (xxx}mmmmm(yy), THE FOLLOWING DATA 
SETS WERE NOT PROCESSED FROM THE 
LOGICALLY FORMATTED DUMP TAPE 
DUE TO ERRORS: 

Explanation: The data sets in the list were not processed. The 


error is identified by other messages that pesreds this message. 
System Action: The return code is 4. 

Programmer Response: Correct the problem according to 
preceding messages. 
Operator Response: 
Problem Determination: | 


None. 
Table I, items 1, 3, 4, 13, 20, and 29. 


ADR481E (xxx+}mmmmm(yy), UNABLE TO ALTER 
VSAM CLUSTER clustername [IN CATALOG 
catname | 

Explanation: The VSAM ALTER NEWNAME failed while 

attempting to alter the source cluster name. 

System Action: Processing continues. The return code is 8. 

Programmer Response: None. 

Operator Response: None. 


Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR482E (xxX}mmmmm(vy), 1/0 ERROR ON DDNAME 
ddname WHILE PROCESSING taperec 
Explanation: 1[/O errors were encountered while the indicated 
type of dump tape record was ceing read during iogical data set 
RESTORE processing. 

System Action: The data set is bypassed. The return code is 8. 
Programmer Response: Use an alternate backup copy to 
restore the data set. 
Operator Response: 
Problem Determination: 


None. 
Table I, items 1, 3,4, 13, 20, and 29. 


ADR483W  (xxx+}mmmmm(yy), DATA SET dsname NOT 
CATALOGED 
Explanation: The data set was not ealpoeee: 


RECATALOG(*) was specified, but the source data set was 
not cataloged. 

System Action: Processing continues. The return code is 4. 
Programmer Response: None. 

Operator Response: None. 


Problem Determination: Table I, items |, 3,4, 13, 20, and 29. 


Chapter 2. System DFDSS Messages 49 


ADR484W — ADR492E 


ADR484W Ss (xxx+}mmmmm(yy), COMMAND IS NOT 
SUPPORTED FOR DATA SET dsname 
DURING LOGICAL DATA SET 
PROCESSING 

Explanation: Data set RESTORE from a logically formatted 

dump tape does not support the data set organization of the 

indicated data set. 

System Action: Processing continues for other data sets. The 

return code is 4. ° 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Tabie I, items 1, 3, 4, 13, 20, and 29. 


ADR48S5E (xxx>mmmmm(yy), CATALOG catname IS NOT 
IN STEPCAT/JOBCAT/MASTERCAT 
STRUCTURE. DATA SET dsname WILL NOT 
BE PROCESSED 

Explanation: The cluster named in the message required 
DFDSS to use [DCAMS or VSAM I/O to perform the COPY 
or RESTORE. This requires that both the source and target 
cluster (allocated by DFDSS) be accessible via the catalog 
structure. 

System Action: Processing continues with the next data set. 
The return code is 8. 

Programmer Response: Add a STEPCAT or JOBCAT JCL 
statement specifying the named catalog, or concatenate it to 
your existing STEPCAT/JOBCAT JCL statement, and rerun 
the job. . 

Operator Response: None. 

Problem Determination: Table [, items 1, 3, 4, 13, 20, and 29. 


ADR4861 (xxx-}mmmmm(yy), UNMOVABLE DATA SET 
dsname RESTORED TO BREE SPACE 
Explanation: The unmovable data set specifiec in the message 
cannot de restorec co the cylincer/track location from which it 
was dumped. Because FORCE was specified in the RESTORE 
command, this data set was restored to free space. 

System Action: Processing continues. 

Programmer Response: None. 

Operator Response: None. 


Problem Determination: Tabie I, items i, 3, 4, 13, 20, and 29. 


ADR487W = (xxx}mmmmm(yy), DATA SFT dsname NOT 
ON LOGICALLY FORMATTED DUMP 
TAPE 

Explanation: During a data set RESTORE from a logically 
formatted dump tape, the data set was not found on the tape. 
Possibly the data set name is contained in the data set name list 
at the beginning of tre dump tape, but the data set was not 
dumped. :This can occur if the data set could not be serialized 
at dump time.) E:ther the wrong input file was used, an 
incorrect data set name was specified, or the data set was 
rejected because of tne DSORG filtering criteria. This message 
is printed if fully quaufied names are specified. 

System Action: Processing continues. The return code is 4. 
Programmer Response: Correct the error, and rerun the ‘ob. 
Operator Response: None. 

Problem Determination: Taodle I, items 1,3, 4, 13, 20, and 29, 
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ADR488E = (xxx}-Fmmmmn((yy), ERROR ENCOUNTERED 
WHILE ACCESSING {VTOC|VVDS} FOR 
DATA SET dsname ON VOLUME volser ON 
DDNAME ddname 

Explanation: An inconsistency on the VTOC or VVDS was 
encountered during data set RESTORE from a logically 
formatted dump tape. 

System Action: Processing continues for other data sets. The 
return code is 8. Bt We Pats oe 
Programmer Response: Use an alternate backup copy to 
restore the data set. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2,3, 4,5, 13, 20, 
25a, 29, 36a, and 36b. 


ADR489I (Xxxx}>mmmmm(yy), 
{dsname|clustername|component name} WAS 
{SELECTED|RESTORED} 

Explanation: After a data set was successfully restored or after 
a data set was successfully selected (when 

TYPRUN = NORUN), the data set name is printed for a 
non-VSAM data set. Component names are printed for a 
VSAM data set. 

System Action: Processing continues. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR490W ss (xxx mmmmmj(yy), ERROR 
{OPENING|READING} UTILITY SYSPRINT 
MESSAGES. UTILITY MESSAGES WILL BE 
LOST 

Explanation: An error occurred either in opening or in reading 
the utlity SYSPRINT file. 

System Action: DFDSS continues orocessing for the task, Dut 
utlity SYSPRINT messages are lost. The return code is 4. 
Programmer Response: None. 

Operator Response: None. 

Problem Determination: Tadile I, item 3 1,3,4, 13, 20, and 29. 


ADRAIIE (xxx}mmmmm(yy), TASK TERMINATED DUE 
TO INSUFFICIENT STORAGE FOR UIM 1/0 
BUFFER AND/OR EXIT IDENTIFICATION 
BLOCK 

Explanation: If the application interface is used, the system 
requires a buffer to pass I/O records to the user interaction 
module (UIM). If virtual storage cannot be obtained for the 
buffer or the UIM exit identification block, the related DFDSS 
function is ended. 

System Action: None. The return code is 8. 

Programmer Response: Increase either the SIZE parameter, 
the region size, or both, and rerun the job. 

Operator Response: None. 

Problem Determination: Taoie I, item s 1,3, 4, 13, 20, 25, and 
35, 


ADR492E (xxx}mmmmm(yy), ERROR OCCURRED 
DURING COPY OF CATALOG catname, 
RC-xx. FEXPORT DATA SET dsname IS ON 
VOLUME volser ] 

Explanation: The catalog was being moved using Access 
Method Services EXPORT or [MPORT when I[DCAMS errors 
occurred. Corrective action may be required to restore the 
source catalog to a usable condition. The reason code describes 
the error as follows: 


01 Anerror occurred when the catalog was exported to a 
temporary sequential data set. The COPY is discontinued, 
and the source catalog remains in usable condition. For 
this reason code, the second portion of the message is not 
printed. 


02 A failure cccurred when the target catalog was imported. 
The source cataiog was deleted and must be recovered by 
the user. 


System Action: Processing continues with the next COPY. 
The return code is 8. 

Programmer Response: Ensure that the DFDSS parameter 
option UTILMSG = YES is specified when running jobs that 
perform catalog moves. All reason codes are accompanied by 
IDCAMS messages that clarify the remedial actions necessary. 
See the System Messages for an explanation of the messages. 


Take the following actions, depending on the reason code: 


01 Use the IDCAMS messages as a guide in correcting the 
error. Rerun the job. 


02 Restore the source catalog before attempting to rerun the 
job. If the catalog was backed up before the COPY was 
atlempted, ine backup can be used to restore the catalog. 
Otherwise, the catalog can be restored by importing the 
catalog from the export data set described in the message. 
See the Access Method Services Reference for an 
eXpianation cf the IMPORT command. Delete the export 
data set described in the message before rerunning the job. 


Operator Response: None. 
Problem Determination: Table I, items 1, 2, 3,4, 13, 20, 25b, 
26, and 29. 


ADR493E (xxx+mmmmm(vy), UNCATALOG/DELETE IS 
NOT ALLOWED FOR DATA SET dsname [IN 
CATALOG catname? 

Explanation: E-iner exeiusive contro! of the data set is not 
obtained or it:s a SYS/. system, page, or swap Gata set that 
cannot be uncata.oged. 


System Action: Processing 


“n 


continues. The return code is 8. 
Ly 


Programmer Response: For exclusive contro: either remove 
Ss 

the SHARE xesword or ensure exclusive controi of the data 

sat, untess the Gita set is a VTOCIX sr a VVDS. For SYSI. 


system, page, or swap data sets, specify PROCESS/(SYS1) to 
uncatalog or Ce.ete the data set. 


Note: PROCESS(SYS1) does not lift processing restrictions 
for VTOCIXs and VVDSs. 

Operator Response: None. 

Probiem Determination: Tabie i, items 1, 3,4. 13, 20, and 29. 


ADR494W (XXX mmmmm(vy), (OPEN: CLOSE:L/O} 
ERROR ON MESSAGE DATA SET FOR 
TASK. TASK RELATED VIESSAGES MAY 
BE LOST 

Explanation: An OPEN, CLOSE, or [/O error occurred on a 

message data se. used to store task-related messages. 

System Action: DFDSS continues processing for the task, out 

messages for ine task may de lost. The return code Is 4. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Tabie I, items !, 3,4, 13, 20, and 29. 


oA a 


ADR493E — ADR497E 





ADR495E (xxx}-}mmmmm(yy), ECB UNEXPECTEDLY 
POSTED IN MODULE modname, ECB 
CONTENTS ARE xxxxxxxx 

Explanation: An ECB related to an attached task was 
unexpectedly posted. 

System Action: Command processing is ended. The return 
code is 8. 

Programmer Response: None.. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3,4, 13, 20, 25a, 25b, 
and 29. 





ADR496E = (xxx }mmmmm(yy), UNEXPECTED RETURN 


CODE an FROM DETACH ISSUED FROM 
MODULE modname 

Explanation: An attempt to detach a subtask failed. 

System Action: The return code is 8. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: See the Application Development 

Guide manual for an explanation of DETACH return codes. 


ADR497E (xxx}mmmmnm(yy), A CATALOG ERROR 


OCCURRED WHILE action-description. 
RETURN CODE IS xx, REASON CODE IS 


nn-yyy 
Explanation: Catalog Management module 1GGOCLnn 


returned this return code, xx, and reason code, yyy, as the 
result of a catalog error or an exception condition while 
DFDSS was performing the action described by 
action-description,. 


Action-description can be any one of the following: 
* RENAMING CLUSTER cusname TO ciusmame2 
* RENAMING COMPONENT compname TO compname2 
* RENAMING AIX aixname TO aixname2 
* RACF PROTECTING asname 
* RACF UNPROTECTING adsname 
* ALTERING ACCESS TO USER CATALOG catname 
* RENAMING DATA SET asname TO dsname2 
*¢ CONVERTING CLUSTER clusname TO SMS 
* CONVERTING CLUSTER clusname TO NONSMS 


* REMOVING CANDIDATE VOLUMES FROM 
COMPONENT compname 


* DEFINING CLUSTER clusname 

* CATALOGING DATA SET dsname 

2» DEFINING AIX aixname 

* DEFINING PAGESPACE dsname 

* DEFINING USER CATALOG cainame 

¢ DEFINING PATH pathname TO clusname 
* DEFINING ALIAS aliasname TO clusname 


* SEARCHING FOR DATA SETS BEGINNING WITH 
prefix 

* OBTAINING INFORMATION FOR DATA SET 
dsname 


* OBTAINING VOLUME INFORMATION FOR DATA 
SET dsname 


* DETERMINING TARGET CATALOG FOR DATA 
SET dsname 
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ADR498E — ADR706E 


¢ DELETING CLUSTER clusname 

¢ DELETING DATA SET dsname 

¢ DELETING USER CATALOG catname 
* DELETING AIX aixname 

* DELETING PATH pathname 

* EXPORTING CATALOG cainame 

* IMPORTING CATALOG <cainame 

* RECATALOGING CLUSTER clusname 
* RECATALOGING AIX aixname 

* RECATALOGING DATA SET dsname 
* READING CATALOG catname 


¢ ALTERING THE VOLUME LIST FOR DATA SET 
dsname. 


System Action: Command processing is enced. The return 
code is 8. 

Programmer Response: See message IDC30091 in the System 
Messages for specific return code and reascn code information. 
For return code 40 or 44, change the DFDSS filtering to 
reduce the number of selected CVOL-cataicged data sets to 
fewer than 1455, or increase the region size :f you are selecting 
fewer than 1455; then rerun the ob. 

Operator Response: None. 

Problem Determination: Table I, items 1, 7. 4, 13, 20, and 29. 


ADR498E (xxx}mmmmm(yy), DATA SET dsname CAN 
NOT BE COPIED/RESTORED. 
PREALLOCATE THE DATA SET WITH trks 
TRACKS 

Explanation: DFDSS canno: citermine .n2 amount of space 
required to contain the data sé: tefore per!c:ming the 

COPY, RESTORE to an unlixe cevice. 

System Action: The data set :s not processec. The return code 
is set to 8, 

Programmer Response: Prea..ccate the cicvz set with an 
allocation of irks tracks on tne volumes ..sisc¢ in message 
ADR396I or ADR4421, or COPY/RESTC RE the data set to a 
xe device. 

Operator Response: None. 

Problem Determination: Taoie [, ites 
29, and 36. 


ADRS500 through ADR699 


| 
| 
| 
i 


" 


Eyvoe 34 13,.20,°26, 


See Chapter 3, “Stand-Alone DFDSS Restore Viessages” 





ADR7O0I1E (XXX+}mmmmmi(vsj3, UNEXPECTED RETURN 
CODE FROMI externalname: xxx-yyy. 
Explanation: The named external routine as called, and it 
returned an unexpected return and/or reason code. 

System Action: Processing is ended. The 72:urn code is 8. 
Programmer Response: This message is .ot normally expected 
and indicates a programming or system crociem. If 
externainame is STORAGE MANAGEMENT SUBSYSTEM, 
ensure that SMS its active. I: SMS is not active, activate SMS 
and rerun the job. If SMS is aiready act:ve, rerun the job with 
PARM ='ABEND=701' on the EXEC statement anda 
SYSUDUMP DD statement, and contac: [BM for 
programming support. 

Operator Response: None. 

Problem Determination: Tatie I, items ‘|. 2,4, 13, 20, and 29. 
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ADR702E (xxx}-mmmmm(yy), JOBCAT/STEPCAT NOT 
ALLOWED WHEN PROCESSING SMS 
MANAGED DATA SET dsname. 

Explanation: A JOBCAT or STEPCAT DD statement was 
specified, and one of the data sets being dumped or copied was 
SMS managed. 

System Action: Task ends with return code 8. 

Programmer Response: Eliminate JOBCAT/STEPCAT in the 
JCL and rerun the job. For those data steps that are not 
cataloged in the standard search order, specify INCAT and give 
one catalog name or a list of catalog names. 

Operator Response: None. 

Problem Determination: Table [, items 1,3, 4, 13, and 29. 


ADR703E (xxx>mmmmm(yy), DATA SET dsname NOT 
SELECTED DUE TO MISSING NVR 
Explanation: The data set, which is non-VSAM and SMS 
managed, was not selected because the non- VSAM volume 
record (NVR) for it cannot be found. 

System Action: The data set is not processed. The return code 
is 8. 

Programmer Response: Run Access Method Services 
DIAGNOSE for the data set, fix the error, and_rerun the job. 
Operator Response: None. 

Problem Determination: Table I, iterns 1, 3, 4, 13, 20, 25b, and 
29. 


(xxx}mmmmm(yy), DATA SET dsname 
ORGANIZATION IS NOT SUPPORTED 
Explanation: The following types of data sets are not 
supported by DFDSS in an SMS environment: 

¢ Data set cataloged in more than one catalog 

* CVOLSs 

¢ ISAM daza sets 

* Absolute track allocation 

* Unmovabie data sets 

¢ VTOCIX/VVDS 

* PAGE/SWAP data sets 

* SYSISTGINDEX data set 

* BDAM Gata sets with OPTCD =A, 
System Action: The data set is not processed, and the return 
code is set to 8. 
Programmer Response: None. 
Operator Response: None. 
Problem Determination: Table I, items 1, 3,4, 13, and 29. 


ADR704E 


ADR705E (xxx+}mmmmm(yy), INVALID {STORAGE 
CLASS | MANAGEMENT CLASS} NAME 
{scname | mcname} SPECIFIED 

Explanation: -\ nonexistent storage class or management class 
was specified in the STORCLAS or MGMTCLAS Keyword. 
System Action: Task ends with return code 8. 

Programmer Response: Specify a valid storage 
class/management class and rerun the job. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3,4, 13, 20, and 
29. 


ADR706E (XXx}mmmmm(yy), DUE TO ERRORS, 
SOURCE DATA SET dsname IS NOW 
NAMED name 

Explanation: During COPY processing, the source data set 
can be renamed in order to allow allocation of the 
SMS-managed target data set. If the target allocation fails, an 
attempt is made to restore the source data set to its original 
state. If the ALTER of the source data set fails, this message 
is issued. The data set name indicates the name of the failing 
data set. 


System Action: Processing continues with the next data set. 
The return code is 8. 

Programmer Response: Run Access Method Services 
DIAGNOSE against the source catalog to determine the 
reason for the Access Method Services ALTER failure. 
Restore the original data set name usinz Access Method 
Services ALTER NEWNAME., 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, 26, 
and 29. 


ADR707E = (xxx+mmmmm(yy), NOT AUTHORIZED TO 
USE {BYPASSACS | CONVERTV | INCAT | 
PROCESS(SYS1) | STORAGE CLASS | 
MANAGEMENT CLASS} {KEYWORD | 
scname | mcname} FOR DATA SET dsname 


Explanation: Proper RACF authority is required as follows: 


* BYPASSACS xeyword—RACF FACILITY class authority 
to bypass ACS. 


* CONVERTVY keyword—RACF FACILITY class authority 
to convert volume. 


¢ INCAT keyword—RACF FACILITY class authority for 
direct catalog call. 


* PROCESS(SYS1) keyword—RACF FACILITY class 
authority to remove restrictions on processing of SYS/ 
system data sets. 


* STORCLAS(scname)—-RACF STORCLAS class authority 
to use storage class scname. The RESOWNER of the data 
set must have the authority to use the indicated storage 
class (which may nave seen chosen for the data set by the 
ACS routines or by the user if BY PASSACS was specified 
for the data set’. 


* MGMTCLAS mconame’—RACF Sf{GMTCLAS class 
authority to use “management class mcname. The 
RESOWNER of tne cata set must nave the authority to 
use the indicated management class ‘which may have been 
cnosen for the <ata set by the ACS routines or by the user 
if BYPASSACS was scecified for tne data set). 


System Action: Other message will :nc:cate action taken. The 
return code is 8. 

Programmer Response: Acquire the o-oper RACF authority 
and rerun the job. For BYPASSACS, you must be permitted 
access to either the STGADMIN.ADR.COPY.BYPASSACS 
or the STGADMIN.ADR.RESTORE.BYPASSACS profiles. 
For CONVERTY, you must be permitted access to the 
STGADMIN.ADR.CONVERTY proiie. For INCAT, you 
must be permitted access to either the 
STGADMIN.ADR.COPY.INCAT or tne 

STGADMIN.ADR., es MP. INCAT - crofiles. For 
PROCESS(SYS!‘, vou must be perm:tted access to the 
STGADMIN.AD 2 COPY PROCESS S YS, 
STGADMIN.ADR.DUMP.PROCESS.SYS, or 
STGADMIN.ADR.RELEASE.PROCESS.SYS profiles. For 
STORCLAS and oe TCLAS, the RESOWNER of the data 
set must be permitted access 10 the aocropriate storage class or 
management class ees ofle. 

Operator Response: None. 

Problem Determination: Table I, items 
and 29. 


1,2, 3,4, 56, 13, 20, 


ADR707E — ADR7III 


ADR708E (xxx}mmmmm(yy), DATA SET dsname WAS 
NOT PROCESSED BECAUSE IT IS 
SMS-MANAGED AND JOBCAT/STEPCAT 
WAS SPECIFIED 

Explanation: DFDSS COPY or RESTORE cannot create an 
SMS-managed data set because JOBCAT or STEPCAT was 
specified. 

System Action: The data set is not processed. The return code 
is 8. 

Programmer Response: Eliminate JOBCAT/STEPCAT in the 
JCL and rerun the job. For source data sets that are not 
cataloged in the standard search order, specify INCAT and give 
one or a list of catalog names. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, and 29. 


ADR709E = (xxx mmmmm(yy), AN ERROR OCCURRED 
IN sms-service WHILE action-description. 
sms-service MESSAGES FOLLOW 

Explanation: An error occurred in the specified SMS service 
while DFDSS was performing the action described by action 
description. Error messages produced by the servicein error are 


printed following this message. ° 


SMS service can be any one of the following: 
* Automatic Class Selection (ACS) 
* VTOC/Data Set Services (VDSS). 


Action description can be any one of the following: 


* DETERMINING SMS CONSTRUCTS FOR DATA SET 
dsname [WITH NEWNAME dsname2] 


¢ ALLOCATING DATA SET dsname [WITH NEWNAME 
dsname2] 


* RENAMING DATA SET dsnamel TO dsname2 
* SCRATCHING DATA SET dsname. 


System Action: The data set is not processed. The return code 
is 8. 

Programmer Response: Refer to the messages following this 
message to determine the actual error and to correct the 
problem. 

Operator Response: None. 

Problem Determination: Table I, items |, 3,4, !3, and 29. 


ADR710E (xxx}-mmmmm(yy), COPYVOLID REQUIRED 
TO {RESTORE|COPY} INPUT VOLUME 
volser! TO OUTPUT VOLUME volser2 
Explanation: The source volume of a FULL voiume COPY or 
RESTORE is SMS managed. In order to perform this 
operation, tne COPYVOLID keyword must oe specified. 
System Action: The function is ended with a return code of 8. 
Programmer Response: [If you want to COPY or RESTORE 
an SMS-managed volume, specify the COPYVOLID keyword 
in the contro! statement, and rerun the job. 

Operator Response: None. 

Problem Determination: Table I, items |, 3,24, 13, 29, and 29. 


ADR7iltI (xxx+}mmmmm(yy), DATA SET dsname HAS 
BEEN ALLOCATED [AS A PDS | AS A PDSE 
] (WITH NEWNAMIE dsname2] USING 
STORCLAS scname {DATACLAS dename|NO 
DATACLAS}, AND {MGMTCLAS 
mcname|NO MGMTCLAS} 

Explanation: If the RENAME parameter was specified, the 
data set has been allocated with the new name in the storage 
class listed. The data class and management class assigned to 
the data set are also listed, if they exist. If the target data set 
of a PDS or a PDSE is allocated with a different type than the 
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source, the new larget type is listed as well, and the data set is 
converted to the new target type. 

System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR712W ss (xxx}mmmmm(yy), THE CATALOG catname 
SPECIFIED IN RECATALOG IS NOT 
AVAILABLE 

Explanation: The catalog specified in the RECATALOG 
parameter does not exist or is not availabie on the system. 
System Action: [f tne target data set is SMS managed, the 
RECATALOG parameter is ignored, and the system 
determines the cataicg. If the target data set is not SMS 
managed, then message ADR380E is issued, and the task 
continues with the next data set. The return code is 4. 
Programmer Response: If the target data set is not SMS 
managed, ensure that the catalog name is correct and available, 
then rerun the jcb. 
Operator Response: 
Problem Determination: 


None. 
Table I, items 1, 3, 4, 13, 20, and 29. 


ADR713E (xxx}mmmmm(yy), UNABLE TO ALLOCATE 
SMS MANAGED DATA SET dsname 
BECAUSE NEITHER DELETE NOR 
RENAMEU WAS SPECIFIED 

Explanation: An attempt to copy a cataloged data set into 
system-managed storage failed because the source data set was 
not deleted and the target data set was not renamed. 

System Action: The data set is not copied. The return code is 
8. 

Programmer Response: Specify either DELETE to delete the 
source Cata setor RENAMEL to rename the target data set, 
TRS a recuse tne. 

Operator Response: Nore. 


Problem Determination: Taebie [, items -, 3,4, 13, 20, and 29. 


ADRTI4E (XXX>mmmmm(s¥), UNABLE TO RESTORE 
USER CATALOG ucatname BECAUSE THE 
SYSTEM-SELECTED TARGET VOLUME 
targetvol DOES NOT MATCH THE SOURCE 
VOLUME sourcevol 

Explanation: A user cataiog must be restored to a volume with 
the same serial number as the volume from which it was 
dumred. Because the user catalog is SMS-managed, the target 
volume is determined by the system. 

System Action: Tae user catalog is not restored. The return 
coce is 8, 

Programmer Response: 
the OU TDODIOLTDY ca 
iS im 2 StoTage class with 
Operator Response: 
Problem Determination: Tacie i, items |. 2, 3,4, 13, 20, and 


2y, 








ADR715W 9 (xxx}¥mmmmmivy), UNABLE TO ALTER 
STATUS OF SMS MANAGED GENERATION 
DATA SET dsname TO ‘ACTIVE | 
ROLLED-OFF). IT WILL BE LEFT IN 
DEFERRED STATUS. 

Explanation: DFDSS was attempting to update the status of 
an SMS-managed generation data set from deferred to either 
active or rolled-off, >at it was unable to do so because of a 

VV ODS manager error. Message ADR23°E describing the 
VVDS manager error will precede this message. 

System Action: The data set is left in deferred status. The 
return code ts 4. 
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Programmer Response: Take the action recommended by 
message ADR231E. To change the status to active, use the 
Access Method Services command ALTER ROLLIN. 
Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, and 


29. 

ADR716W = (xxx}+mmmmm(yy), UNABLE TO CONVERT 
USER CATALOG catname {TO | FROM} SMS 
MANAGEMENT. VOLUME volser HAS 
BEEN PLACED IN INITIAL STATUS. 

Explanation: DFDSS physical data set restore has restored a 


non-SMS-managed Integrated Catalog Facility user catalog to 
an SMS-managed volume or an SMS-managed user catalog to 
a non-SMS-managed volume without performing the 
appropriate conversion to or from SMS management. To avoid 
contaminating the volume, it was placed in INITIAL status. 
System Action: The user catalog is restored, and the output 
volume is placed in INITIAL status. The return code is 4. 
Programmer Response: 


¢ Connect the user catalog to the master catalog. 


* Use the DFDSS CONVERTV command to return the 
volume to its status before the restore. CONVERTV will 
also perform the appropriate conversion on the user 
catalog. 


Operator Response: None. 
Problem Determination: Table J, items 1, 3, 4, 13, and 29. 


(xxx}>mmmmm(yy), SYSTEM SERVICES 
ERROR OCCURRED WHILE 
action-description. (RETURN INFORMATION 
IS vy-ii-ww-zzz | ABEND CODE IS nnn} [AND 
MESSAGES FOLLOW:) 

Explanation: 


ADR7I7E 


* The system services’ version number (vv), module ID (ii), 
return code (ww), and reason code (zzz) were returned as 
the result of an error or exception condition while DFDSS 
was performing the action described by 
“action-description.” 


e {If the systern services abended, nnn is the abend code. See 
Sysiem Codes for an explanation of tne adend code, 
DFDSS was performing the action described by 
“action-description” at the time of the abend. 

Action-description can be any one of the following: 

* RACF PROTECTING dsname 

* RACF UNPROTECTING dsname 

* RENAMING DATA SET dsname TO dsname2 


* OBTAINING INFORMATION FOR DATA SET 
dsname 


* OBTAINING VOLUME INFORMATION FOR DATA 
SET dsname 


* DETERMINING TARGET CATALOG FOR DATA 
SET dsname 


* ALTERING THE CHECKPOINT ATTRIBUTE OF 
DATA SET dsname 


¢ DUMPING DATA SET dsname 
¢ COPYING DATA SET dsname 
* RESTORING DATA SET dsname 


System Action: The data set is not processed. The return code 
is 8. 


Programmer Response: Refer to [GW0O1zzz in the System 
Messages following this message to determine the actual error 
and the measures to be taken to correct the problem. 
Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR718W ss (xxx+}mmmmm(yy), SYSTEM SERVICES 
ENCOUNTERED A WARNING CONDITION 
WHILE action-description. RETURN 
INFORMATION IS vy-ii-ww-zzz [AND 
MESSAGES FOLLOW:} 

Explanation: The system services’ version number (vv), module 
ID (il), return code (ww), and reason code (zzz) were returned 
as the result of a warning condition while DFDSS was 
performing the action described by “action-description.” 


Action-description can be any one of the following: 
* COPYING DATA SET dsname 
* RESTORING DATA SET dsname 
¢ DUMPING DATA SET dsname 


System Action: Processing continues with the next data set. 
The return code is 4. . 

Programmer Response: Refer to 1GW0O12zzz in System 
Messages following this message to determine the actual error 
and the measures to be taxen to correct the problem. 
Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR719E (xxx}mmmmm(yy), DATA SET dsname 
CANNOT BE CONVERTED TO {A PDSE|A 
PDS }. 

Explanation: CONVERT keyword with PDS or PDSE 

suakeyword was specifie¢ in the COPY command for the data 


set. However, it 
reason code (re}: 


etal hen anda Hak of, Doe ; DAN wae ee heey a 
cannot Te sonvertec cecause of the following 


Ol The target data set is preallocated, and its data set type 
conflicts witn the CONVERT PDS-cr CONVERT PDSE 
xeyword. For examcle, if CONVERT PDSE is specified, 
the preallocated targe: data set must be a PDSE. 


02 The target volume for the data set is not SMS-managed. 
03 PDSE support is not availaole. 


04 Conversion to a PDSE was requested with CONVERT 
PDSE keyword, but the source PDS was a load module. 
Load moduies cannot be converted to a PDSE with DFP 
Version 3 Release 2. 


on) 
in 


Conversion to PDS was requested with the CONVERT 
PDS keyword, Dut ine target PDS was prealiocated as a 
load meduie. A PDSE cannot te converted to load 
modules with DFP Version 3 Retease 2. 

System Action: The Gata set is mot precessed. The return code 
is 8. 

Programmer Response: Correct the problem as indicated by 
the reason code (rcj and reorocess the cata set: 

O01 Rename or delete the creallocatec data set. 


02 Specify an SMS-managed target volume or modify the 
ACS routine to direct the target ailocation to an 
SMS-managed volume. 

03. Do one of the following and rerun the job: 

* Use INCLUDE/EXCLUDE;BY filtering so that the 
data set is not seiected 

° Delete the data set. 

* Ensure that SMSX is available on your system. 


ADR718W — ADR729E 


04 Change or remove the CONVERT PDSE keyword 
specification so that conversion to a PDSE is not 
attempted for load modules. 


0S Rename the PDSE or delete the preallocated target PDS 
so that conversion to a load module is not attempted for 
the PDSE. 


Operator Response: None. 
Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 





ADR724E (xxx-¥mmmmm(yy), ERROR DURING function 
FOR DATA SET dsname [IN CATALOG 
catname J, vv-li-wwW-Zzz. 

Explanation: The version number (vv), module ID (ii), return 
code (ww), and reason code (2zZ) were returned by the catalog 
services as the result of a catalog error or an exception 
condition. 

System Action: Command processing is ended. The return 
code is 8. 

Programmer Response: See [GW0O1z2z in System Messages for 
specific return code and reason code definitions. - 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR725E (xxx>mmmmm(yy), INTERNAL BUFFERING 
ERROR ENCOUNTERED FOR DATA SET 
dsname [IN CATALOG catname] WHILE 
INTERFACING WITH SYSTEM SERVICES 
FOR DATA MOVEMENT 
Explanation: An error was detected in the I/O buffer table. 
This is probably an internal error in DFDSS. 

System Action: Processing ends for the data set. Processing 
continues with the next data set that is not a PDSE. The 
return code is 8. 

Programmer Response: Contact IBM for crogramming 
supper. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3,4, 13, 20, and 29. 


ADRT2i7E (XXx}¥mmmmmyy), DATA SET dsname WAS 
NOT PROCESSED BECAUSE IT IS NOT 
CATALOGED IN THE STANDARD ORDER 
OF SEARCH 

Explanation: The data set, which is SMS-managed, was not 
selected because it was found to be cataloged outside the 
standard order of search. 

System Action: The data set is not processed. The return code 
is 8. 

Programmer Response: Correct the situation and rerun the 
jon. 

Operator Response: None. 

Problem Determination: Table [, items !, 3,4, 13, 20, 26, and 
29, 


ADR729E (xxx-}mmmmm(yy), UNABLE TO ALLOCATE 
SUFFICIENT SPACE TO PROCESS DATA 
SET dsname. IT CANNOT BE 
COPIED/RESTORED 

Explanation: DFDSS is unable to allocate sufficient space to 
contain the data set. 

System Action: The data set is not copied/restored. The return 
code 1s 8. 

Programmer Response: If possible, prealiocate the target data 
set with the appropriate amount of space. Otherwise, contact 
IBM for programming support. 

Operator Response: None. 

Problem Determination: Table [, items 1, 2, 3, 4, 13, 20, 26, 
29, and 36. 
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ADR730W — ADR746W 


ADR730W = (xxx}}mmmmm(yy), CLUSTER clustername IS 
OPEN 

Explanation: The specified VSAM cluster is in open-for-update 
status. This condition will not prevent the data set from being 


processed. 


If the function this message was issued against was either data 
set dump or data set copy, the cluster will be backed up or 
copied. 


Note: The data set may be unusable if the source was in the 
process of being updated. 


If the function this message was issued against was data set 
restore, the backup copy being restored was open at the time of 
dump. The restored data set may or may not be usable. 
System Action: The cluster will be dumped, copied, or restored 
if it is selected. The return code is 4. 

Programmer Response: For dump or copy, close the cluster 
and rerun the job if a compiete copy is necessary. For restore, 
use the access method services verify or examine commands to 
ensure that the cluster is usable. 

Operator Response: None. 

Problem Determination: Table 1, items 1, 2, 3, 4, 13, 20, and 
29. P 


ADR731E (xxx+}mmmmm(yy) THE SIZE OF THE BLOCK 
OF DATA ACTUALLY READ, NNNNN 
BYTES, IS NOT A MULTIPLE OF LRECL, 
MMMMM. DATA SET dsname [S NOT 
PROCESSED. 

Explanation: During a DFDSS data set COPY or RESTORE 
with REBLOCK specified, an inconsistency was detected 
between the size of a block of data actuaily read from the 
user’s data set and the LRECL obtained from the VTOC entry. 
For a data set with RECFM = FB to ce ‘egitimate, all blocks of 
data in the data set must be an integer multiple of LRECL. All 
blocks do net have to be the same iength, but they must all be 
an integer muitiple of LRECL. One or more blocks of data in 
the cata set named in the message does not meet this criteria. 
System Action: The data se: :s not processed. The return code 
is 8. Processing continues ror other data sets. 

Programmer Response: I[nszect the data set for any LRECL 
anomalies, and correct anv that you find. Retry without 
specifying REBLOCK. 

Operator Response: None. 

Problem Determination: Table I, items |, 
29. 


3, 4, 13, 20, 25a, and 


ADR732E (Xxxx}mmmmm(yy) DATA SET dsname WAS 
NOT SELECTED BECAUSE IT IS NOT 
CATALOGED 

Explanation: During DFDSS logical DUMP or COPY with 
or without INCAT specified, the VSAM data set is not selected 
because its entry was deletec from the catalog before the 
DFDSS job was run. 

System Action: The data set is not selected. The return code is 
8. Processing continues for other data sets. 

Programmer Response: Insvect the cataiog for the entry of the 
VSAM data set listed in the message. Lse IDCAMS to 
recatalog the VSAM if the data set is not found. 

Operator Response: None. 

Problem Determination: Tabdie I, items 1, 
29. 


3,4, 13, 20, 25a, and 
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ADR7331 (xxx}-mmmmm(yy) DATA SET dsname DOES 
NOT HAVE A RECORD FORMAT OF FIXED 
OR FIXED BLOCK|HAS A STANDARD 
USER LABEL. RELATIVE BLOCK 
ADDRESS PROCESSING WILL NOT BE 
USED. 

Explanation: The keyword RELBLOCKADDRESS was 
specified, but the data set did not have a record format of fixed 
or fixed block, or the data set had a standard user label. The 
data set cannot be processed using relative block address. 
System Action: Processing continues without the use of 
relative block address. 

Programmer Response: None. 

Operator Response: None. 


ADR744W ss (xxx}mmmmm(yy), NO VALID MEMBERS 
WERE FOUND FOR PDS dsname. ONLY THE 
DIRECTORY WILL BE UPDATED 

Explanation: No members were found in the PDS or all 


members found had invalid starting TTRs. This message is 
preceded by message ADR745W for each member with an 
invalid start TTR. 

System Action: Only the directory of the data set is processed. 
The return code is 4. , 

Programmer Response: For a data set with no members, no 
user action is required. For a data set with all invalid member 
start TTRs, see message ADR745W for direction. 

Operator Response: None. 

Problem Determination: Table I, items 1,3, 4, 13, 20, 25a, and 
29. 


ADR745W ss (xxxmmmmm(yy), STARTING TTR ttttrr FOR 
MEMBER memname IN PDS dsname IS 
INVALID. REASON CODE IS xx 

Explanation: The starting TTR of the named memoer is 


invalid for one of tne following reasons: 


04 The TTR points to a record before the end of the 
directory, 


08 The TTR points to a record after the enc of the data set 


as given in the DSCB1 DS!LSTAR field. 


the TTR points to a Dlock after the 
aa valid Bick on ne indicated track. 


System Action: The member data is not processed. The 
directory entry for the member is transferred unchanged to the 
target data set. The return code 1s 4. 

Programmer Response: The data set does not conform to 
standard conventions for a PDS. If the data set must be 
moved as is, rerun the job by specifying the data set in the 
NOPACKING keyword list and by providing at .east one 
target volume of a like device as the volume on which the data 
set resides. 
Operator Response: 
Problem Determination: 


None. 
Tabie [, items 1, 3,4, i3, 20, 25a, and 


29. 

ADR746W = (xxxmmmmm(yy), END OF DIRECTORY 
RECORD MISSING FOR PDS dsname 

Explanation: The PDS specified does not have an end-of-file 


(EOF) record for the directory or the EOF is not in the correct 
place. 

System Action: An EOF record is supplied for the directory if 
the NOPACKING keyword is not specified. Processing 
continues for this data set. The return code is 4 

Programmer Response: The data set does not conform to 
standard conventions for a PDS. If the data set must be 
moved as is, rerun the job by specifying the data set in the 


NOPACKING keyword list and by providing at least one 
target volume of a like device as the volume on which the data 
set resides. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, 25a, 25c, 
and 29. 





ADR747W ss (xxx-mmmmm(yy), HIGH MEMBER ENTRY 
MISSING FOR PDS dsname 

Explanation: Tne PDS specisied does not have a high member 
entry (member name = all ’FF’s). This entry signifies the 
position of the last active member in the directory. 

System Action: The high member entry is supplied for the 
directory if the NOPACKING keyword is not used. 
Processing continues for this data set. The return code is 4. 
Programmer Response: The data set does not conform to 
standard conventions for a PDS. If the data set must be 
moved as is, rerun the job by specifying the data set in the 
NOPACKING keyword list and by providing at least one 
target volume of a like device as the volume on which the data 
set resides. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, 25a, 25c, 
and 29. 


ADR748W  (xxx}mmmmmfvy), TTR ttttrr IN MEMBER 
member OF PDS dsname IS INVALID. BYTE 
OFFSET IS annn IN {DIRECTORY ENTRY | 
CCHHR cchhrr}. REASON CODE IS xx 
Explanation: The user or notelist TTR found in the given PDS 
was invalid and cannot be translated by DFDSS track-packing 
logic. The TTR points to a record outside the bounds of the 
current member Seing processed or past the end of valid 
recorcs On 4 tracx within ine member. The absolute disk 
address of the source TTR -:f in a notelist) and is offset 


tne record or Cirectory entry are given. 





O04 The TTR soints to 2 t.ock before the starting olock for 
the memcer as indicates in the member directory entry. 
08 The TTR points to a siock after the ending block for the 


mombker 
memcer, 


12. The record portion of tne TTR points to a block after the 
last valid block on the indicated track. 


16 The record portion of the TTR is zero. Valid blocks 
begin at one. 


System Action: Tre TTR :s copied without change. 
Processing for tnis data se. continues. The return code is 4. 
Programmer Response: a3 data set does not conform to 
Standard conventions for a PDS. If the data set must be 
moved as is, rerun the lop ty soecifying the data set in the 
NOPACKING keyword Ust and by previding at least one 
target volume cr a like device as the volume on which the data 
set resides. 

Operator Response: None. 

Problem Determination: Tacie [, items !, 3, 4, 13, 20, 25a, 25c, 
and 29, 


< 


& 
~ 
t 
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ADR749W = (xxx}mmmmm(yy), END OF FILE RECORD 
MISSING FOR MEMBER member OF PDS 
dsname AT TTR ttttrr 

Explanation: During the copy or restore of a PDS, an 
expected end of file record for the member specified was not 
found before the starting TTR of the next member. The 
directory shows the next member should start at the given 
TTR. 

System Action: An end of file record is supplied for the 
member at the TTR given. Processing continues with the next 
member in the data set. The return code is 4. 

Programmer Response: The data set does not conform to 
standard conventions for a PDS and may contain additional 
errors that cannot be detected by DFDSS. If the data set must 
be moved as is, rerun the job by specifying the data set in the 
NOPACKING keyword list and by providing at least one 
target volume of a like device as the volume on which the data 
set resides, 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, 25a, 25c, 
and 29. 


ADR750E (xxx+}mmmmm(yy), PROCESSING FOR DATA 
SET dsname IS TERMINATED TO PREVENT 
DELETION OF THE SOURCE DATA SET 
Expianation: An invalid condition or structure was detected in 
the data set during processing. The DELETE keyword was 
also specified. In order to preserve the source data set and 
preclude possible data integrity problems, DFDSS ends the 
processing after data movement and deletes the target data set. 
The invalid condition might be: 


¢ Invalid TTRs detected in the directory or member entry. 
* Missing EOF record for a member. 


System Action: The specified data set was not copied, and the 
return code is set to 8. Processing continues with the next data 
set. 

Programmer Response: Correct the invalid conditions to have 
the PDS copied. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, 25a, 25c, 
and 29. 


ADR7S5S1E (xxx}mmmmm(yy), (OPEN | WRITE {| CLOSE) 
FAILED WITH RETURN CODE (rc) FOR data 
set IN AN ATTEMPT TO EXTEND THE 
DATA SET 

Explanation: DFDSS cannot extend the data because the 
OPEN, WRITE, or CLOSE fatied for the data set. 

System Action: The data set is not processed. The return code 
is 8. 

Programmer Response: See ihe Data Management Macro 
Instructions manual for an explanation of return codes. 
Operator Response: None. 

Problem Determination: See the Data Management Macro 
Instructions manual. 


ADR7S2E (xxx}mmmmm(yy), (OPEN | WRITE | CLOSE) 
ABENDED WITH ABEND CODE (rc) FOR 
data set INAN ATTEMPT TO EXTEND THE 
DATA SET 

Explanation: DFDSS cannot extend the data because the 
OPEN, WRITE, or CLOSE for the data set abnormally ended. 
System Action: The data set is not processed. The return code 
is 8. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items |, 3,4, 13, 20, and 29. 
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ADR753E (xxx}+mmmmm(yy), UNABLE TO ESTABLISH 
ESTAE EXIT 

Explanation: DFDSS cannot register an ESTAE exit to the 
system and, therefore, cannot process abends. 

System Action: The data set is not processed. The return code 
is 8. 

Programmer Response: None. 

Operator Response: None. 


Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR760W = (xxx-}mmmmm(yy), DATA SET dsname WAS 


NOT DUMPED WITH SPHERE KEYWORD 
SPECIFIED 
Explanation: An attempt to restore a cata set at the sphere 
level that was not dumped at the sphere ‘evel failed. 
System Action: Only the data set wili ce restored (no other 
sphere information will be restored). The return code is 4. 
Programmer Response: Rerun the joo without specifying 
SPHERE. 
Operator Response: None. 
Problem Determination: Table I, items i, 3, 4, 13, 20, and 29. 


ADR761W = (xxx+}mmmmm(yy), CLUSTER cluster name IN 


CATALOG catalog name WAS RESTORED 

WITHOUT SPHERE INFORMATION 
Explanation: DFDSS tried to restore 2 YSAM cluster that was 
dumped as part of a VSAM sphere. The cluster will be 
restored, but no relationship informaticn will be created. If the 
cluster is a base cluster, then any existing alternate indexes 
might have to be rebuilt. Likewise, if the cluster is an alternate 
index, it might not properly reflect the current state of its base 
cluster. 
System Action: The data set is restored. The return code is 4. 
Programmer Response: if the intent #2: to restore the entire 
sphere, rerun tne icc, specifving the SPHERE keyword. 
Operator Response: None. 


Problem Determination: Tabie I, items :, 3,4, 13, 20, and 29. 


ADR762W  (xxx®mmmmm(vy), AIX atxname OF BASE 
CLUSTER clusname ALREADY EXISTS 
RELATED TO BASE CLUSTER ciusname IN 
CATALOG catname 

Explanation: During DFDSS sphere o:ccessing in which 
REPLACE was specified but the prea.located target was not, 
an alternate index with the same name was found in the target 
catalog. This alternate index is related to a base cluster that is 
different from the source base cluster. 

System Action: The base cluster was successfully processed, 
but the specified AIX was not processec. Processing continues 


with the next AIK. The return code ts - 
Programmer Response: Use Access Mfeinod Services 
commands to DEFINE the AIX with 2 a:fferent name, 


DEFINE a path, anc ound iBLDINDEN) the alternate index. 
Operator Response: None. 

Problem Determination: Taole I, items 
and 29. 


thi Ae 4a :ey 200, 2ec, 


ADR763E (Xxx}mmmmm(yy), DATA SETS IN SPHERE 
OF BASE CLUSTER clusname [WITH 
NEWNAME clusname2_) WERE NOT ALL 
RENAMED. 

Explanation: When copying a sphere without specifying 
DELETE or RECATALOG, you mus: rename all parts of the 
sphere. If the target sphere is to be SN{S managed, the data 
sets must be renamed even if RECATALOG was specified, 
because RECATALOG is ignored for $SMS-managed data sets. 
System Action: Processing continues wth the next data set. 
The return code is 8. 
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Programmer Response: Do one of the following, then rerun 
the job: 


¢ Specify the DELETE or RECATALOG keyword. 


* Add or change the RENAMEU keyword specification to 
rename all data sets in the sphere. 


Operator Response: None. 
Problem Determination: Table I, items 1, 3, 4, 13, 20, 25a, 25b, 
26, and 29. 


ADR764E (Xxx}mmmmm(yy), DATA SETS IN SPHERE 
OF BASE CLUSTER clusname [WITH 
NEWNAME clusname2] WERE DIRECTED 
TO MORE THAN ONE CATALOG 
Explanation: The data sets in the sphere were directed by the 
standard order of search to more than one catalog. The 
VSAM base cluster, data and index components, AIXs, AIX 
components, and path names of a sphere must ail resolve to 
the same catalog. 

System Action: Processing continues with the next data set. 
The return code is 8. 

Programmer Response: Ensure that all data sets in the sphere 
are directed to the same catalog, using one or more of the 
following techniques: 


¢ Adding or deleting user catalog aliases 


* Renaming the data sets with the RENAME or 
RENAMELU keyword. 


Rerun the job. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, 25a, 25b, 
26, and 29. 


ADR765W (xxx}mmmmm(yy), SPHERE OF BASE 
CLUSTER clusname IN CATALOG catname [S 
NOT COMPLETE ON THE DUMP TAPE 
Explanation: DFDSS sphere processing detected that not ali of 
the sphere components are on the dump tape. DFDSS is 
unable to locate ail of the alternate indexes related to the 
named Dase cluster on the dump tape because of errors 
encountered when the sphere was dumped. [f the sphere was 
Drealiocated, the existing alternate indexes that were not on the 
dump tape will not reflect the current state of the restored base 
cluster and will need to be rebuilt. The named meataiOe is the 
source catalog of the sphere. 
System Action: This error is not detected until after the base 
cluster of the sphere is processed. All alternate indexes on the 
dump tape are restored, and processing continues with the next 
data set. The return code is 4. 
Programmer Response: Take the apcropriate action: 

* For non-prealiocated data set RESTORE, check the 
DFDSS messages for the AlXs that were restored, use 
Access Method Services commands to define the as 
AIXs, define paths for them, and build (BLDINDEX) th 
AIXs. 

* For preallocated data set RESTORE, check the DFDSS 
messages for the AlXs that were restored, and use the 
Access Method Services command BLDINDEX to rebuild 
the existing alternate indexes that were not restored. 

Operator Response: None. : 
Problem Determination: Table [, items 1, 3,4, 13, 20, 25b, 25c, 
and 29. 


ADR766E (xxx}>mmmmm(yy), CLUSTER clusname [WITH 
NEWNAME clusname2] CANNOT BE 
MOVED TO {AN SMS | A NONSMS} 
TARGET BECAUSE IT IS PART OF {AN 
SMS | A NONSMS} MANAGED SPHERE [IN 
A DIFFERENT STORAGE GROUP] 
Explanation; When DFDSS copies with DELETE between 
SMS and NONSMS or between different storage groups in 
SMS, all parts of a VSAM sphere must be included. 

System Action: Processing continues with the next data set. 
The return cade is 8. 

Programmer Response: Do one or more of the following, then 
rerun the joo: 


* Specify RENAMEL or RECATALOG instead of 
DELETE, 


* Specify SPHERE to include all parts of the sphere. 


¢ Specify all parts of tne sphere in the data set INCLUDE 
parameter. 


Operator Response: None. 
Problem Determination: Table I, items 1, 3, 4, 13, 20, 25b, 25c, 
26, and 29. 


ADR768W ss (xxx}mmmmm(yy), THE FOLLOWING 
SPHERE(S) COULD NOT BE COMPLETELY 
PROCESSED DUE TO ERRORS 

Explanation: During DFDSS sphere processing, one or more 
components of a sphere could not be successfully processed. 
The message lists the status of each piece of the sphere. 

System Action: If possible, processing continues with the next 
sphere comrorent for COPY and RESTORE, or the next data 
set for DUMP. If the command was DUMP, processing for 
each individual sohere nalts if an error was detected with an 
AIX. The return code cs =. 

Programmer Response: Crecx other: DFDSS messages for tne 
components that failec. Arter correcting the error conditions, 
run the job again. 

Operator Response: Nore. 

Problem Determination: Taoie I, items !, 3,4, 13, 20, 250, 25c, 
and 29. 


ADR769E (Xxx+}mmmmm(yy), PROCESSING OF DATA 
SET dsname TERMINATED BY UIM EXIT 
(nn) 

Explanation: The indicated User [Interaction Module exit nn 
has ended processing for -ne named Gata set before normal 
completion. If the SPHERE keyword is specified and the 
named data set :s a base c.uster, processing for ail related AlXs 
is also endec. 

System Action: Process:nz continues with the next data set. 
The return code :s 8. 

Programmer Response: None. 

Operator Response: Nore. 
Problem Determination: Table [, items 1, 3, 4, 13, 20, 25a, 25b, 


26, and 29. 

ADR770W = (xxx}mmmmm(yy), AIX aixname RELATED TO 
BASE CLUSTER clustername WAS NOT 
TERMINATED AS REQUESTED BY UIM 
EXIT (nn) 

Explanation: The indicated User Interaction Module exit (nn) 

requested that crocessinz for the named alternate index be 


ended. The request was cenied because the SPHERE keyword 
was specified and the a..ernate index is related to the named 
base cluster that was se.ected for processing. 

System Action: Processing continues for the named alternate 
index. The return code :s +. 


ADR766E ‘— ADR773E ~ 


Programmer Response: Take one or more of the following 
actions: 


¢ Copy only the base cluster by omitting the SPHERE 
keyword. 


* Change the UIM exit so that termination is not attempted 
tor the alternate index. 


Operator Response: None. 
Problem Determination: Table I, items 1, 3, 4, 13, 20, 25a, 25b, 
26, and 29. 


ADR772W = (xxxmmmmm(yy), UMM EXIT (nn) [S NOT 
AUTHORIZED TO BYPASS SECURITY 
PROCESSING FOR DATA SET dsname 
Explanation: The indicated User Interaction Module exit (nn) 
attempted to bypass RACF and security processing for the 
named data set. The request was denied because the 
application program was not authorized to bypass security 
because the JSCBPASS flag was off in the job step control 
block, 

System Action: Processing continues with normal security 
processing for the data set. The return code is 4. 
Programmer Response: Alter the application so that it is 
authorized to bypass security processing by ensuring that the 
JSCBPASS flag is on in the job step control block, or change 
the UIM exit so that it does not attempt to bypass security 
processing. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, 25a, 25b, 
26, and 29, , 


ADR773E (xxx+-mmmmm(yy), PREALLOCATED TARGET 
DATA SET dsname [IN CATALOG catname ] 
ON VOLUMIE voiser WAS NOT SCRATCHED 
AND REALLOCATED BECAUSE DFDSS DID 
NOT SERIALIZE THE DATA SET, re 
Explanation: DFDSS did not delete and reallocate a 
preallocated target data set because DFDSS did not serialize 
the target cata set. DFDS5 neeced to deiete and reallocate the 
preallocated target because one or more target data set 
attrioutes did not match the source. The reason code (rc) is as 
follows: 


i The target KSDS on an unlike device was not reusabie. 


3 The CI size of the target did not match the source. 


4 The IMBED attribute of the target did not match the 
source, 

5 The KEY length of tne target did not match the source. 

6 The Record length of tne target did not maich the source. 

7 Tne REPLICATE attribute of the target did not maten 
the source. 

8 The SPANNED attribute of the target did not match the 
source. 

3 The size of the target data set was smaller than the size 


of the source data set. 
B Vhe source data set is empty. 


DFDSS probably bypassed serialization because UIM exit 22 
requested that serialization be bypassed for the data set. 
System Action: The data set is not processed. Processing 
continues with the next data set. The return code is 8. 
Programmer Response: Do one of the following, then rerun 
tne job: 

* Delete the preallocated target and allocate it with attributes 

that match the source data set. 
« Delete the preallocated target and iet DFDSS allocate it. 
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*« Change UIM exit 22 so that it does not bypass 
serialization. 
Operator Response: None. 
Problem Determination: Table I, items 1, 3, 4, 13, 20, 25a, 25b, 


26, and 29. 

ADR774E (XXxX}mmmmm(vy), DATA SET dsname 
CANNOT BE PROCESSED BECAUSE 
CONVERSION TO A {PDS |PDSE } WAS 
NOT REQUESTED, re 

Explanation: The named cata set cannot be processed because 


the CONVERT xeyword was not specified. The possible 
reason codes (rc) are: 


04 The source data set is a PDSE, but there is a usable 
preallocated PDS data set on the target volume, and 
CONVERT with PDS subkeyword was not specified for 
the data set. 


08 The source data set is a PDS, but there is a usable 
preallocated PDSE data set on the target volume, and 
CONVERT with PDSE subkeyword was not specified for 
the data set. 


12 The data set being processed is a PDSE, and the target 
volume for the data set is not SMS-managed. A PDSE 
must be cuacawepe cies 


16 A PDSE Is Seing cepiec to an MVS/DFP Version 3 
Release 2 (or nae releases) system that does not 
have MVS/SP Version 3 Release 1.0E. Allocation of 
PDSE requires at least MVS/DFP Version 3 Release 2 
and MVS/SP Version 3 Release 1.0E. 


System Action: 
is 8. 
Programmer Response: Correct the probiem as indicated by 
the reason code ‘rc: and recrocess the data set: 


The data set is not processed. The return code 


04 Ifthe source PDSE ‘s :c De copied to the preallocated 
target PDS, specify CONVERT with PDS subkeyword; 
otherwise, delete or rename the preallocated target PDS. 


08 Ifthe source PDS is i te copied to the preailocated 
target PDSE. scecifty CONVERT with PDSE 
subkeywora, otherwise, celete or rename the preallocated 
target PDSE. 


12 If the PDSE is to be cozied to a non-SMS managed 
volume, specify CONVERT with PDS subkeyword; 
otherwise, specify an S\{S-managed target volume, or 
modify the ACS routine to direct the target allocation to 
an SMS-managed volume. 


16 Specify CONVERT w:t2 PDS subkeyword to copy and 
convert the PDSE to PDS, or copy the data set on a 
system that nas at leas: \IVS/DFP Version 3 Release 2 
and MVS/;SP Version 3 Release i.0E. 


None. 
Tate 


Operator Response: 


Problem Determination: [, items 1, 3, 4, 13, 20, and 29. 


ADR780I (XXxX>mmmmm(v¥), THE INPUT DUMP DATA 
SET BEING PROCESSED IS IN {FULL 
VOLUME | TRACKS | PHYSICAL DATA SET 
| LOGICAL DATA SET} FORMAT 

Explanation: The dump data set now being processed was 


created using the indicated format. 

System Action: Processing ccnunues. 

Programmer Response: None. For information on logical and 
physical processing see Data Facility Data Set Services: User's 
Guide. 

Operator Response: 
Problem Determination: 


None. 
None. 
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ADR7811 (xxx}-mmmmm(yy), DATA SET dsname [IN 
CATALOG catname] HAS AN UNDEFINED 
DSORG. TRACK LEVEL I/O WILL BE 
USED TO PROCESS THE DATA SET TO AN 
UNLIKE DEVICE 

Explanation: The data set has an undefined data set 
organization and is being moved to an unlike target device. 
Track image data movement will be used.. This. results in an 
exact track-for-track image of the source data set on the target 
volume. 

System Action: Processing continues. 

Programmer Response: None 

Operator Response: None 

Problem Determination: None 


ADR782W = (xxx>mmmmm(yy), DATA SET dsname HAS AN 
INVALID DSORG. VSAM PROCESSING IS 
BYPASSED 

Explanation: The VVDS data set has an invalid data set 


organization, and VSAM processing will not be performed. 
System Action: Processing continues. The return code is 4. 
Programmer Response: Notify Systems sept 

Operator Response: None a 

Problem Determination: None 


ADR799E (XXX+}mmmmm(yy), AN UNEXPECTED ERROR 
HAS OCCURRED [WHILE PROCESSING 
{DATA SET datasetname | VOLUME volser}] 
Explanation: DFDSS detected an unexpected error during 
processing. It was possibly an internal error. 


System Action: If possible, DFDSS attempts to continue 
processing; otherwise, the task ends. The return code is 8. 
Programmer Response: Contact IBM for programming 
SUPPOrt. 

Operator Response: 
Problem Determination: 
29. 


None. 


Table I, items 1, 3, 4, 13, 20, 26, and 


ADR8601 (Xxx+mmmmm(yy), PROCESSING BEGINS ON 
VOLUMIE volser 

Explanation: DFDSS began processing the named volume. 
System Action: None. 

Programmer Response: None. 

Operator Response: None. 


Problem Determination: None. 


ADR861T (xxx-}mmmmm(yy), REQUIRED SUBSYSTEM 
subsys IS UNAVAILABLE. TASK IS 
TERMINATED 

Explanation: The indicated subsystem is not installed. I[t is 

required to perform the CONVERT Y function. 


System Action: Tre :ob is ended. The return code is 12. 
Programmer Response: Verify tha: the indicated subsystem is 
installed, and rerun tne job. 
Operator Response: None. 
Problem Determination: Table I, 
and 29, 


13, 20, 25a, 25b, 


ADR862I (xxx}mmmmm(yy), THE REDETERMINE 
KEYWORD WAS SPECIFIED. ALL DATA 
SETS WILL BE REPROCESSED 
Explanation: The REDETERMINE keyword was specified in 
the SMS job stream. The SMS constructs for all of the data 
sets will be reset, including those data sets already SMS 
managed. 

System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR863I (xxx}mmmmm(yy), THE TEST KEYWORD 
WAS SPECIFIED. NO DATA SETS OR 
VOLUMES WILL BE CONVERTED 
Explanation: The TEST keyword was specified in the SMS job 
stream. Subtasks will run in the NORUN mode. 

System Action: No volumes or data sets will be converted, but 
volume and data set eligibility checking will be done. A report 
will be issued indicating whether SMS processing would be 
successful, 

Programmer Response: None. 

Operator Response: None. : 

Problem Determination: None. 


ADR864E (xxx+}mmmmm(yy), JOBCAT/STEPCAT IS 
NOT ALLOWED WHEN CONVERTING 
VOLUMES TO OR FROM SMS 
MANAGEMENT. TASK IS TERMINATED 
Explanation; A JOBCAT or STEPCAT DD statement was 
encountered, These statements are not allowed in the SMS 
environment. 

System Action: The task is not performed. Processing 
continues with the next control statement. The return code is 
8. 

Programmer Response: Remove the JOBCAT or STEPCAT 
DD statement. Use the INCAT keyword if it is necessary to 
specify an input catalog. Rerun the job. 

Operator Response: None. 

Problem Determination: Table I, items 1, 3, 4, 13, 20, and 29. 


ADR8681 (xxxX}mmmmnoi(yy), THE FOLLOWING DATA 
SETS ON VOLUME volser HAD {'*'} 
CANDIDATE VOLUMES WHICH WERE 
{DELETED| CONVERTED TO '*'} 
Explanation: During conversion to SMS, non-VSAM data sets 
with candidate volumes have the candidate volumes converted 
to nonspecific '*' volumes. During conversion from SMS, 
both VSAM and non-VSAM data sets have their nonspecific 
'*' volumes deleted. 

System Action: None, 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR8691 (xxx-mmmmn(yy), THE FOLLOWING DATA 
SETS ON VOLUME volser WERE NOT 
CATALOGED IN THE STANDARD ORDER 
OF SEARCH. THEY (WERE|WILL BE} 
CATALOGED IN THE NAMED CATALOG 
dsname CATALOG: new catalog name 

{OELETED FROM: old catalog name] 


Explanation: Catalog entries were not found for each of the 
listed data sets in the standard order of search. The listed 

VSAM data sets were deleted from their original catalog and 
recataloged in the standard order of search. For non-VSAM 
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data sets, if the INCAT keyword was specified and an entry for 
the non-VSAM data set was found in one of the catalogs listed 
with this keyword, then that entry was deleted from this catalog 
and the data set was recataloged in the standard order of 
search. 


If INCAT was not specified or no entry was found in any of 
the catalogs listed, then the system assumed that the 
non-VSAM data set was uncataloged and cataloged it in the 
named catalog. In this case, the DELETED FROM line will 
not be issued. 

System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR870!I (xxx}mmmmm(yy), PREPARE PROCESSING 
{WILL BE|WAS} SUCCESSFUL. VOLUME 
volser (WILL NOW BE|IS NOW} IN INITIAL 
STATUS 

Explanation: PREPARE processing for the named volume 
completed successfully, and the volume is now in INITIAL 
Status. No data sets can be allocated or deleted on the volume. 
If TEST was specified in the job stream, this message indicates 
whether the task will be successful if actually run. The volume 
Status is not changed with TEST. 

System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR871W = (xxx}mmmmm(yy), VOLUME volser MUST BE 
ASSIGNED TO A STORAGE GROUP 
BEFORE SMS CONVERSION CAN 
PROCEED 

Explanation: This message is issued with a PREPARE task if 

the named volume is eligible for SMS conversion but is not 

assigned to an SMS storage group. The volume will be 

successfully placed in INITIAL status but must be assigned to 

a storage group before the conversion to SMS management 

can be completed. 

System Action: None. The return code is 4. 

Programmer Response: Change the active control data set so 

that the volume is defined to a storage group before attempting 

to convert the volume to SMS management. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, and 

29. , 


ADR872E (XxxX}mmmmm(yy), VOLUME volser IS 
ALREADY IN {INITIAL|CONVERTED} 
STATUS. PREPARE PROCESSING {WILL 
FAIL|FAILED} 

Explanation: PREPARE processing for the named volume 
failed because the volume was already in INITIAL status. 
System Action: Processing of that volume is ended. 
Processing continues with the next volume in the input volume 
list. The return code is 8. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, 25a, 
25b, and 29. 
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ADR873I — ADR878E 


ADR873I (xxx}-mmmmm(yy), VOLUME volser [IN 
STORAGE GROUP storgrp] IS ELIGIBLE 
FOR CONVERSION {TO/FROM} SMS 
MANAGEMENT 

Explanation: DFDSS determined that the named volume is 
eligible for SMS/non-SMS processing. Conversion of the data 
sets On that volume can now proceed. Storgrp is the SMS 
storage group in which the volume is defined. The storage 
group is listed only when a volume is converted to SMS 
management. 

System Action: The system proceeds with converting all of the 
data sets on the named volume either to or from SMS 
management. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR874E (xxx}>mmmmm(yy), VOLUYIE volser IS NOT 
ELIGIBLE FOR CONVERSION {TO|FROM} 
SMS MANAGEMENT, re 

Explanation: The named volume failed the eligibility 
requirements for conversion either to or from SMS 


management. re is the reason code for the ineligible volume: 
04 The volume is not a DASD device. 

08 The volume has a nonindexed VTOC. 

12 The volume is not defined to an SMS storage group. 


16 The volume is in unknown status. Tne SMS-converted 
flag is on but the SMS-initial flag is off in the VTOC 
index map. 


20 The volume is in unknown status. The SMS-converted 
flag is on but the SMS-initial flag is off in VTOC entry. 


24 SMS indicators for VTOC index mac and VTOC entry 
do not match. 


System Action: Conversion of the volume failed. Processing 
continues with the next volume in the incut list. The return 
code is 8. 

Programmer Response: Take the approcr:aie action for each 
reason code: 


04 Do not attempt to convert non-DASD volumes to SMS 
management. 


08 Define an index for the VTOC, and rerun the job. 


12 Change the ACDS so that the volume is defined to a 
storage group, and rerun the job. 


16 Contact IBM for programming succort. 
20 Contact [BM for programming supcort. 
24 Contact IBM for programming supoort. 


Operator Response: None. 
Problem Determination: Table I, items 1, 2, 3,4, 13, 20, 25a, 
25b, and 29. 


ADR875E (xxx+}mmmmm(yy), VOLUNIE volser IS 
ALREADY IN CONVERTED STATUS AND 
REDETERMINE WAS NOT SPECIFIED. 
SMS PROCESSING {WILL FAIL|FAILED} 
Explanation: The named volume was already in SMS status, 
and the REDETERMINE keyword was not specified in the 
DFDSS job stream. Therefore, SMS processing of that volume 
is ended. 

System Action: Processing continues with the next volume in 
the input volume list. The return code is 8. 

Programmer Response: None. 

Operator Response: None. 
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Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, and 
29. 





ADR876E (xxx}mmmmm(yy), VOLUME volser IS NOT IN 
INITIAL OR CONVERTED STATUS. 
NONSMS PROCESSING {WILL 
FAIL|FAILED} 

Explanation: Because the named volume was already in 
non-SMS status, non-SMS processing of the volume is ended. 
System Action: Processing continues with the next volume in 
the input volume list. The return code is 8. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, 25a, 
25b, and 29. 


ADR8771 (xxx>mmmmm(yy), THE FOLLOWING DATA 
SETS ON VOLUME volser (WILL BE|WERE} 


SUCCESSFULLY PROCESSED 


dsname CATALOG: catname 
[STORCLAS: scname MGMTCLAS: mcname] 
(VOLUMES: vol@@1 volQ02 vol003 . . .j 
if vol06x vol@@y vold@z .. .] 


(AIX: aixname] 
(PATH: pathname] 


Explanation: The listed data sets were successfully processed 
either to or from SMS management. 


* At the end of processing they are cataloged in the named 
catalog. 


¢ If the task was conversion to SMS management, the 
storage and management classes in which the data set is 
defined are listed. 


¢ If the data set is multivolume, the volumes on which the 
data set resides are listed. 


¢ If the data set has any AlXs or PATHs defined for it, 
these are listed. If anv of the AI Xs are multivolume, then 
the volumes on which they reside are listed. 


If TEST was specified, the data sets were not actually 
processed. The message indicates that data sets would be 
successfully processed if the job was run. 

System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR878E (xxx+mmmmm(yy), THE FOLLOWING DATA 


SETS ON VOLUME volser {WILL NOT 
BE|WERE NOT} SUCCESSFULLY 
PROCESSED 


dsname CATALOG: catalog name 
REASON: rc,mmmmm(yy)[,volser}{,reason]} 
{,catlg func,catlg rsn code,catlg mod id, 
parmlist rsn code,catlg service id] 
(,VVR func, VVDS manager rsn code] 
AIX: aix name rc{,volser][,reason] 
{,cat!g func,catlg rsn code,catlg mod id, 
parmlist rsn code,catlg service id] 
{,VVR func, VVDS manager rsn code] 
PATH: path name rc 
{,catlg func,catlg rsn code,catlg mod id, 
parmlist rsn code,catlg service id] 
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. Explanation: The listed data set (or its associated AIX or 
PATH) failed conversion either to or from SMS management, 
where “rc” is the reason code for the data set failing. If the 
data set is multivolume and the error occurred on a volume 
other than the one being processed by CONVERTV at that 
time, then the volser of this other volume is printed. If a 
multivolume data set fails conversion because one of the other 
volumes that the data set is on is ineligible for SMS processing, 

then this reason is-printed after the volser. If the error ~ - 
‘occurred in a catalog call, then the catalog function code, 
catalog reason code, catalog module ID, and parmlist reason 
code are printed. Refer to MSGIDC3009I in System Messages 
for an explanation of the error, where: 


MSGIDC3009I return code = MSGADR878E catlg 
rsn code 
MSGIDC3009I reason code = MSGADR878E 


parmlist rsn code 
MSGIDC30091 module 1D = MSGADR878E ails 
mod ID 


If the error occurred in a VVR REQUEST function call, then 
the VVR function code that failed and the VVDS manager 
reason code are printed. Refer to Message IDC3009] in 
System Messages under return code 50 for an explanation of 
the VVDS manager reason code. ° 


The reason codes are: 


02 The data set is not supported in an SMS environment 
(ISAM, ABSTR, unmovable, model DSCB, CVOL, 
nonintegrated catalog facility VSAM catalog, or 
nonintegrated catalog facility VSAM data set). 


03 The data set is not supported i in a non- SMS eaviconncnt 


(PDSE data set). 
04 The data set is an uncataloged GDS. 


06 The data set is a cataiczed GDS, but it 
the standard order of search. 


$ not cataloged in 


08 The data set is a GDS with nonspecific volumes. 


10 The data set :s a GDS with candidate volumes. 


12 ACS routines did not return SMS constructs for the data 
set. 


14 A null storage class was returned for the data set. 


16 The storage class definition cannot be retrieved for the 


data set. 


18 The data set is multivolume, extents on volumes volsers 
are not specified in the volume list, and ALLMULTTI is 
not specified. 


20 The data set is multivo:ume and Be first extent of the 
data set is on the volume volser that was not specified in 
the DDNAME/DYNAM list. 


21 The data set is multivoiume and the first extent of an 
AIX of the data set is on the volume volser that was not 
specified in the DDNAME/DYNAM list. 


22 The data set is multivclume and has extents on volumes 
volsers that are in different storage groups. 


24 The data set has candidate volumes volsers that are in 
different storage groups. 


26 The data set is muitivolume and has extents on volumes 
volsers that are ineligible for conversion for the reasons 
given. (Refer to message ADR874E for volume reason 
code.) 


28 The data set has candidate volumes volsers that are 
ineligible for conversion for the reasons given. (Refer to 
message ADR874E for volume reason code.) 


30 
32 


36 


38 


40 


42 


44 


46 


48 


49 


50 


60 


62 


64 


66 


68 


70 


72 


74 


76 


78 








_ The data set is multivolume and is not cataloged. 


The data set is not cataloged in the standard search order, 


-and the CATALOG keyword was not specified: 


The data set is not cataloged in the standard search order, 
and a duplicate entry was found in another catalog. 


The data set is not cataloged in the standard search order, 


_ |. and a duplicate entry was found in a a standard order of 
"search catalog. ite. . OP aeaiths . 


The VSAM base cluster is in a sphere where all data sets 
are not convertible to SMS management. 


The catalog to which the AIX’s sphere is directed is 
different from the catalog to which the AIX’s related base 
cluster is directed. All components must be in the same 
catalog. 


The catalog to which the path’s sphere is directed is 
different from the catalog to which the path’s related base 
cluster is directed. All components must be in the same 
catalog. 


ALTER failed during an attempt to update the catalog 
entry for the data Set. 


DELETE NOSCRATCH failed during a an attempt to 
delete the catalog entry for the data set. 


DEFINE RECATALOG failed during an attempt to 
recatalog the data sete 


= 


DEFINE ALIAS failed during an attempt to define the 
aliases for the data set. 


DEFINE CATALOG failed during an attempt to catalog 
the data set. 


CATALOG NAME LOCATE failed during an attempt 
to determine where the data set should be cataloged 
according to standard order of search. 


DEFINE PATH failed during an attempt to define a 
path. 


LOCATE failed. 


The VSAM base cluster is in a sphere that includes data 
sets with catalog errors. 


Read non-VSAM volume record (NVR) failed in the 
VVDS manager. 


Get for update of non-VSAM volume record (NVR) 
failed in the VVDS manager. 


Put for update of non-VSAM volume record (NVR) 
failed in the VVDS manager. 


Delete of non-VSAM volume record (NVR) failed in the 
VVDS manager. 

Insert of non- VSAM voiume record (NVR) failed in the 
VVDS manager. 


Read VSAM volume record (VVR) failed in the VVDS 
manager. 


Get for update of VSAM volume record (VVR) failed in 
the VVDS manager. 


Put of VSAM volume record (VVR) fatied in the VVDS 
manager. 


The VSAM base cluster is in a sphere that includes data 
sets with VVR errors. 


Read of the VTOC failed during an attempt to update the 
SMS indicator for the data set. 
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80 Rewrite of the VTOC failed during an attempt to update 
the SMS indicator for the data set. 
82 The VSAM base cluster is in a sphere that includes data ~ 
sets with VTOC entry update errors. 
84 The VSAM component does not have a corresponding 
VTOC entry. 
_86 The non-VSAM data set is. SMS Samant mari its NVR 
">. eannot be found. ~~ . z 
88 Storage class authorization for the data set failed. 
90 Management class authorization for the data set failed. 
92 Both storage class and management class authorization 
for the data set failed. 
94 Unable to get extent information from the VTOC. 
96 The data set failed enqueue. 


System Action: Processing continues with the next data set. 
The volume will not be successfully converted to or from SMS 
management. The return code is 8. 

Programmer Response: 


02 - 10 


Move. or delete the data set from the volume. . 


Update ACS routines to return SMS constructs (ae 
the data set. 


14 - 16 Verify ACS routines to ensure that the Gate set is 


' defined to a storage class. 


18 (1) Add the other volumes that the data set resides 
on to the volume list, or (2) specify the. 
ALLMULTI keyword, or (3) move or delete the 


data set off the volume you are trying to convert. 


20 (1) Add the primary volume of the data set to the 
volume list, or (2) move or delete the data set off 


the volume you are trying to convert. 


21 (1) Add primary volume of the AIX to the volume 
list, or (2) move or delete the data set off the 


volume you are trying to convert. 


22 Change your active control data set so that all the 
volumes that the data set resides on are defined to 


the same storage zZroup. 


24 (1) Delete the candidate volumes from the data set’s 
catalog entry, or {2) change your ACDS so that all 
the candidate volumes are defined to the same 

storage group as the volumes on which the data set 


resides. 
26 - 28 Refer to 


30 


message ADR874E for required action. 


(1} Cataiog the data set, or (2) move or delete the 
data set from the volumes that you are trying to 
convert. 


(1) Specify the CATALOG keyword, or (2) 
recatalog the data set into the standard order of 
search. 


32 


34 (1) Catalog the data set into the standard order of 
search, or (2) rename the data set, or (3) move or 
delete the data set from the volumes that you are 


trying to convert. 


36 (1) Rename the data set, or (2) move or delete the 
data set from the volumes that you are trying to 


convert. 


38 - 42 (1) Rename the offending base cluster, the data or 
index component, AIX, AIX data or index 
component, or PATH to be directed to the same 


catalog as the VSAM base cluster, or (2) delete or 
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add catalog aliases so all parts of the sphere | are 
alias-directed to the same catalog. 


Contact IBM for programming support. 


(1) Make sure that the RESOWNER of the data set _ 
is authorized to use the storage and/or management 
class derived for the data set, or (2) update the ACS 
routines to select a different storage aneion 
“Management class for- the data, set. ake gr 2h 


88 - 92, 





See previous error message “associated with the ‘data 
set for specific action. 


94 


96 Ensure that no other jobs are accessing data sets on 
volumes to be converted, then rerun the 


CONVERTYV job. 


Operator Response: 
Problem Determination: 
25b, and 29. 


None. 
Table I, items 1, 2, 3, 4, 13, 20, 25a, 





ADR8791 (xxx}-mmmmm(yy), THE FOLLOWING DATA 
SETS ON VOLUME volser WERE ALREADY 


IN {NON-}SMS STATUS 


ce aees dsname sors yr 





fete Lane ne, i CATALOG: - ‘catname 7 
[STORCLAS: scname ‘* MGMTCLAS:* mename) ‘ 
(VOLUMES: vol@01 vol002 vol003.... J 
( vol0Qx volQQy vold@z... ] 

[AIX: aixname] 

(PATH: pathname] 


Explanation: The listed data sets were not processed because 
they were already in the desired SMS status. 


¢ The data sets are cataloged in the named catalog. 


* If the task was conversion to SMS management, the 
storage and management classes in which the data set is 
defined are listed. 


weeeexex Asterisks (*) shown in the place of storage and 


management class names indicate that no 
primary VVR was found for the cluster. 


Dashes (-) shown in the place of storage and 
management class names indicate incorrectly 
converted old format VVRs. Refer to messaze’ 
ADR4OQE, 


e If the data set is multivolume, the volumes on which the 
data set resides are listed. 


° If the data set has any AlXs or PATHS defined for it, 
these are listed. If any of the AI Xs are multivolume, then 
the volumes on which they reside are listed. 


System Action: None. 
Programmer Response: None. 
Operator Response: None. 
Problem Determination: None. 


ADR880I (xxx+}mmmmm(yy), VOLUME volser IS 
EMPTY. NO DATA SETS WERE 
CONVERTED. 

Explanation: Data set conversion was not required because the 


named volume did not have any data sets defined on it. 
System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 





“ ADR881I1 ss (xxx}}mmmmm(yy), VOLUME volser 
CONTAINS THE FOLLOWING 
TEMPORARY DATA SETS 

dsname 
_ Explanation: 


The named volume contains the temporary data .. 
. sets listed. ES cae i ae 
System Action: None. 
Programmer Response: None. 
Operator Response: None. 
Problem Determination: None. 


(xxxX}mmmmm(yy), THE FOLLOWING DATA | 
SETS ON VOLUME volser (WILL NOT 
BE|WERE NOT} SUCCESSFULLY 
PROCESSED, BUT WERE ALREADY IN 
{NON}SMS STATUS. 


dsname 
REASON: 


ADR882W 


CATALOG: catalog name 
rc,mmmmm(yy)[,volser]{,reason] 
{,catlg func,catlg rsn code,catlg mod id, 
parmlist rsn code,catlg service id] 
an VVR func, VVDS manager rc} 


AIX: aix name rc(,volser][,reason] 
f,catlg func,catlg rsn code,catls mod id, 
parmlist rsn code,catlg service id] 
C. WR func, VV¥DS manager rc] 


PATH: path name rc 
{,catig func,catlg rsn code,catig mod id, 
parmlist rsn code,catlg service id] 


Explanation: An error was found while the listed data set (or 

its associated AIX or PATH) was being processed, but the data 

set was already converted, so this error will not affect the 

volume being successfully converted. “re” is the reason code 

for the data set’s failing. Refer to message ADR878E for a full 
explanation of the data set error information returned and the 
reason codes. 

System Action: Processing continues with the next data set. 

The return coce is 4. | 
Programmer Response: Refer to message ADR878E. | 
Operator Response: None. 

Problem Determination: Table [, items 1, 2, 3,4, 13, 20, 25a, 


25b, and 29, | 

ADR885I— (xxx}mmmmm(yy), VOLUME volser (WILL | 
BE|}HAS BEEN}! SUCCESSFULLY 
CONVERTED {TO|FROM) SMS | 
MANAGEMENT 

Explanation: A!! data sets on the named volume were 


successfully converted to either SMS or non-SMS status. The | 
SMS flags in the VTOC entry and the VTOC index map for 

the volume were successfully updated to the appropriate status. | 
If TEST was specified, this message indicates that processing 

would have been successful if the job had actually been run. 

No changes occur to the volume under TEST. 

System Action: Processing continues with the next volume in 

the input volume list. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


(xxx}mmmmm(yy), DATA SETS EXIST ON 
VOLUME volser WHICH ARE NOT 
CONVERTIBLE {TO|FROM} SMS 
MANAGEMENT. THE VOLUME {WILL 
BE|WAS} {PLACED|LEFT} IN INITIAL 
STATUS 

The named volume failed SMS/non-SMS 


ADR886E 


Explanation: 


: conversion because of data.sets that cannot be converted 


existing on the volume. The volume is left'in INITIAL status 
at the end of processing. If TEST was specified, this message 
indicates that processing would have failed if the job had 
actually been run. No changes occur to the volume under 
TEST. 

System Action: Processing continues with the next volume in 
the input volume list. The return code is 8. 

Programmer Response: Appropriate responses are: 


* For SMS processing, the problem can be solved by one of 
the following: 


- Adding the CATALOG, INCAT, and/or ALLMULTI 
keywords to the DFDSS job stream, and rerunning the 
job. 

_7 Running a non-SMS job to place , the volume back in 

*"-‘non-SMS status, ‘deleting or moving the data sets that’ 
caused the processing to fail, and rerunning the SMS 
job. 


© For non-SMS processing, the preblenics can be solved by | 
one of the following: 


- Adding the ALLMULTI mobi: to the DFDSs job 
~~" stream, and rerunning the job.’ 
— Running an SMS job to place the volume back i in SMS 
status, deleting or moving the data sets that caused the 
processing to fail, and rerunning the non-SMS job. 


Operator Response: None. 
Problem Determination: Tabie I, items 1, 2, 3, 
256, and 29. 


4, 13, 20, 25a, 


ADRS89IE (xxx}mmmmmn((yy), 
{CONVERSIONIPREPARATION} OF 
VOLUME volser FAILED, re 

Explanation: The SMS/NONSMS/PREPARE job failed on the 


named volume because of an error in trying to update the 
VTOC entry or VTCC index map SMS status flags. re is the 
reason code for the failure. 


04 Read of the VTOC entry failed during an attempt to 
update the SMS indicators to INITIAL. 


08 Read of the VTOC entry failed during an attermct to 
update the SMS indicators after processing data sets. 


12. Rewrite of the VTOC entry failed during an attempt to 
update the SMS indicators to INITIAL. 


16 Rewrite of the VTOC entry failed during an attempt to 
update the SMS indicators to NONSMS. 


20 Rewrite of the VTOC entry failed during an attempt to 
update the SMS indicators to SMS. 


24 Read of the VTOC index map failed during an attempt to 
update the SMS indicators to INITIAL. 


28 Read of the VTOC index map failed during an attempt to 
update the SMS indicators after processing data sets. 


32 Rewrite of the VTOC index map failed during an attempt 
to update the SMS indicators to INITIAL. 


36 Rewrite of the VTOC index map failed during an attempt 
to update the SMS indicators to NONSMS. 
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40 Rewrite of the VTOC index map, failed during an attempt 
to Mpaete the SMS indicators to SMS. 


44. An attempt to determine if a VVDS exists on the volume 
failed. 


48 An attempt to adda VVDS to the vclume failed. 


System Action: Processing continues with the next volume in 


_the input volume list. The return code is 8. saith i 
‘Programmer Response: Contact IBM for prcerenming” 
support. 


Operator Response: None. 
Problem Determination: Table I, items 1, 2, 3, 4, 13, 20, and 
29. 





ADR892I (xxx}+-mmmmm(yy), THE STATUS OF EACH 
VOLUME {WILL BE|IS} AS FOLLOWS 


VOLUME FINAL STATUS REASON FOR FAILURE 


volser - PREPARED INITIAL 
volser - CONVERTED SMS|NONSMS| INITIAL 
volser - FAILED | SMS|NONSMS|INITIAL VOLUME NOT ELIGIBLE 


“~ yolser-- FAILED ““SMS|NONSMSFINITIAL “DATA SETS NOT ELIGIBLE 


volser - FAILED SMS[NONSMS| INITIAL VTOC UPDATE FAILED 
volser - FAILED SMS|NONSMS|INITIAL YVDS ERROR 


Explanation: . After all of the volumes in the CONVERTV job 
are processed and individual volume and data set processing 
messages are printed, DFDSS issues this report summary 
message, which lists all of the volumes and their final-status. If 
conversion of a volume failed, the reason fer failure is also 
indicated, 

System Action: None. 

Programmer Response: If ary of the voiumes failed 
processing, refer to that volume’s specific srocessing messages 
to determine the reason for failure and corrective action for the 
error. 

Operator Response: None. 

Problem Determination: None. 


ADR8931 (xxx}mmmmm(yy), THE FOLLOWING 
VOLUMES CONTAIN PIECES OF 
MULTIVOLUME DATA SETS WHICH WERE 
PROCESSED DURING THE CONVERTV 
TASK. THE VOLUMES ARE IN THE 
INDICATED STATUS 


volser - SMSIINITIA. | NONSMS | UNKNOWN 


Explanation: Some data sets processed curing the 
CONVERTY job were multivolume anc -ac extents on 
volumes not in the input voiume list. For SMS processing, the 
SMS status of these volumes is not alterec. For non-SMS 
processing, the volumes are set to INITI FAL if at least one data 
set with extents on those volumes was successfully processed. 


Note: If this message is issued, the user —ay have pieces of 
SMS-managed data sets on non-SMS volumes. These volumes 
must also be converted to SMS management. 

System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 
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- ADR894E *-(xxx}mmmmm(yy), ERRORS OCCURRED 
WHILE TRYING TO PLACE THE 
FOLLOWING VOLUMES IN INITIAL 
STATUS 


deleee - reason code 


Explanation: Some data sets processed during the NONSMS 


. .CONVERTY job were multivolume and had extents on _ 
~ volumes not in the input volume list. An error occurred in 


trying to set the SMS status of these listed volumes to 
INITIAL. Refer to message ADR891E for the explanation of 
the reason code. 

System Action: None. The return code is 8. 

Programmer Response: Contact IBM for programming 
support. 

Operator Response: None. 

Problem Determination: Tabie I, items 1, 2, 3, 4, 13, 20, 25a, 
25b, and 29. 
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Chapter 3. Stand-Alone DFDSS SINC HGS 


This chapter describes stand-alone DFDSS restore 
messages. See Chapter 1, “How to Read DFDSS 
and Stand-Alone DFDSS Restore Messages,” for 
an explanation of the message format. 


ADR501W INVALID CARD CODE. CORRECT ERROR. 
DEPRESS INTERRUPT KEY. 

Explanation: An invalid card code appeared in the last card 

processed. 


System Action: The system enters a wait state, awaiting 
operator response. 

Programmer Response: None. 

Operator Response: Probable user error. Check for and 
correct keypunch or multipunch errors. Reset the card reader. 
Press the interrupt key and continue processing. Refer to 
Appendix A, “Use of Interrupt Key” on page 75 for 
information On interrupt key usage in stand-alone 
environments. 

Problem Determination: Table I, items 2, 20, and 29. 


CONTROL STATEMENT ERROR. JOB 


ADRS02A 
_ TERMINATED. 
Explanation: A control statement contains an incorrect ~ 


keyword, parameter, or name field. 

System Action: The job is ended. 

Programmer Response: Probable user error. Check for 
keypunch errors. Correct xeyword, parameter, or name fields. 
Resubmit the job. 

Operator Response: None. 

Problem Determination: Table I, items 2, 20, and 29. 


ADRS503A STATEMENT SEQUENCE ERROR. JOB 
TERMINATED. 

Explanation: Either the statements are not in proper sequence 
or unnecessary statements are present. 

System Action: The job is ended. 

Programmer Response: Probable user error. Correct control 
statement sequence, or remove unnecessary statements. 
Resubmit the job. 
Operator Response: 
Problem Determination: 


None. 
Table I, items 2, 20, and 29. 


ADRS504W SVC INTERRUPT. JOB TERMINATED 
Explanation: An unknown SVC interrupt occurred. This 
program does not issue SVCs. 

System Action: The job ends. 

Programmer Response: None. 

Operator Response: Rerun the program. 


Problem Determination: Table I, items 11, 15, 20, and 29. 


ADRSO0SA DEFINE INPUT DEVICE. 

Explanation: The input device must be identified to the system 
by the operator, as specified under “Operator Response.” 
System Action: The system waits for the operator’s response. 
Programmer Response: None. 

Operator Response: Prepare the input device by placing 
control statements in it. Load the source tape on the source 
device and prepare it. Enter the following message from the 
console: 


© Copyright [BM Corp. 1988, 1991 


Problem Determination: “None... 


ADRSO7A 


‘INPUT=dddd, cuu 


where dddd is the device type, and cuu is the channel and unit 
address of the input device. 


ADRS06A THE VOLID IN CONTROL STATEMENT 
DOES NOT AGREE WITH ID IN VOL 
LABEL WHICH FOLLOWS. VOLID= xxx 

Explanation: The VOLID parameter in the control] statement 


did not match the volume serial number, xxx, found on the 
receiving volume. 

System Action: The job is ended. - 
Programmer Response: Probable user error. 
and resubmit the job. 
Operator Response: 
program. 

Problem Determination: Table [, items 2, 15, 20, 28, and 29. 


Correct the error 


Mount the correct volume, and rerun the 


ENTER CONTROL CARD STATEMENT 
Explanation: The input control statements are being entered 
from a console; this message is a prompt. 

System Action: None. 

Programmer Response: None. 

Operator Response: Enter the control statements for JOB, 
MSG, RESTORE, and, optionally, VDRL, and then ee 
Problem Determination: None. 


ADRS101 BAD TRACK cchh 

Explanation: A defective track was found at the location 
specified by cc, the cylinder number, and hh, the head number. 
System Action: None. 

Programmer Response: Make sure that message ADR5111 
was issued for each bad track. 

Operator Response: None. 

Problem Determination: None. 


ADRS1iI ALTERNATE cchh | NONE 

Explanation: An alternate track at the location specified by cc, 
the cylinder number, and hh, the head number, is the track that 
replaces the defective track. 

System Action: None. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR552W PROGRAM INTERRUPT. JOB 
TERMINATED. 
Explanation: A program interrupt occurred. 


System Action: The job is ended. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 2, 11, 20, and 29. 
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ADRSS3A 


MESSAGE. DEPRESS INTERRUPT KEY. 
Explanation: The console failed to read the input message. 
System Action: The system waits for the Opsrer Ss response. 
Programmer Response: None. 
Operator Response: Press the interrupt key, and attempt to 
enter the input message again. Refer to Appendix A, “Use of 
Interrupt Key” on page 75 for information | on. a inet ene key 


Bally Ye 


Problem Determination: Table I, item 30. 


ADRSS4A READY READER cuu. DEPRESS 
INTERRUPT KEY. 

Explanation: The reader on channel c, unit uu, has a card or 
transport jam or is out of cards. 

System Action: The system waits for the operator’ s beeDOnsee 
Programmer Response: None. 

Operator Response: Correct the faulty condition, ready the 
reader, and press the interrupt key to continue the program. If 
the card or transport jam occurs again, reproduce the jammed 
cards and try again. Refer to Appendix A, “Use of Interrupt 
Key” on page 75 for information on interrupt — usage in 
stand-alone environments. - ss 
Problem Determination: Table L iter 30. 


ADRSS5A READY PRINTER cuu. DEPRESS 
INTERRUPT KEY. 

Explanation: The printer on channel c, unit uu, is not ready. | 
This can be caused by a forms check, an open interlock, or the 
STOP key being pressed. 

System Action: The system waits for the operator’ $ response. 
Programmer Response: None. 

Operator Response: Correct the faulty condition, ready the 
device, and press the interrupt xey. Refer to Appendix A, 
“Use of Interrupt Key’ on page 75 for information on 
interrupt Key usage in stand-a.cne environments. 

Problem Determination: Tabie I, item 30. 


ADRS56A READY TAPE cuu. DEPRESS INTERRUPT 
KEY. 

Explanation: The tape drive on channel c, unit uu, is not 

ready. 


System Action: The system waits for the operator’s response. | 
Programmer Response: None. 

Operator Response: Correct the faulty condition, ready the | 
device, and press the interrupt key. Refer to Appendix A, 

“Use of Interrupt Key” on page 75 for information on 

interrupt xey usage in stand-aione environments. 

Problem Determination: Tabie [, item 30. 


ADRSS7A READY DASD cuu. DEPRESS INTERRUPT 
KEY. 

Explanation: The direct-access device on channel c, unit uu, Is 

not ready. 


System Action: The system waits for the operator’s response. 
Programmer Response: None. | 
Operator Response: Correct the faulty condition, ready the | 
device, and press the interrupt xey. Refer to Appendix A, 

“Use of Interrupt Key” on page 75 for information on 

interrupt key usage in stand-aione environments. 

Problem Determination: Table I, item 30. 


ADRSS8A WRONG TAPE ON cuu. COND = 
MOUNT PROPER TAPE. 
Explanation: The tape on the drive on channel! c, unit uu, does 


not pertain to this job. The values of “x” are: 
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CONSOLE FAILED TO READ LAST -: Pawar + 





1 vee his i is nota DF DSS-created dump tape, or, if it is, the 
“ "stand-alone program does hot support the format.6n the 
;;, tape. (The tape may have been created by an incompatible 


DFDSS release.) 


An incorrect tape was mounted in response to ADRS6IA. 


3 The dump tape is not compatible with the function 
_ Specified. A full volume RESTORE is being copa 
“et from a tracks ae Physical data Set DuMe tape BE 


5 A RESTORE i is ‘being attempted from. a ‘DFDSS Version - 
logical data set dump tape. 





System Action: The system waits for the operator’s response. 
Programmer Response: None. 

Operator Response: Probable user error. Mount the correct 
tape, and press the interrupt key to continue. Refer to 
Appendix A, “Use of Interrupt Key” on page 75 for 


information on interrupt key usage in stand-alone . ~ 


environments. 
Problem Determination: Table I, items 2, 11, 20, 28, and 29. 


ADRS5S9A READER CHECK. CORRECT ERROR. 
DEPRESS INTERRUPT be 
-Explanation:" A reader check occurred.» Se ae 


System Action: The system waits for the operator’ 5 response. 
Programmer Response: None. 

Operator Response: Correct the faulty condition, and clear the 
reader check. Ready the reader and continue the program by 
pressing the console interrupt key. Refer to Appendix A, “Use 
of Interrupt Key” on page 75 for information on interrupt key 
usage in stand-alone environments. If reader checks occur 
frequently, check the input cards with a card guide for ° 
off-punched cards. Ensure that the cards are both punched 
correctly and in good condition. 

Problem Determination: Tabie I, itern 30. 


ADRS60A PRINT CHECK. CORRECT ERROR. 
DEPRESS INTERRUPT KEY. 

Explanation: A print check occurred. 

System Action: The system waits for the operator’s response. 
Programmer Response: None. 

Operator Response: Clear the print check by pressing Check 
Reset on the printer. Press the interrupt key on the console to 
continue processing. Refer to Appendix A, “Use of Interrupt 
Key” on page 75 for information on interrupt key usage in 
stand-alone environments. 


Problem Determination: Table I, item 30. 





ADRS61A END OF TAPE. MOUNT TAPE ON cuu. 
DEPRESS INTERRUPT KEY. 
Explanation: It is the end of the present tape reel on channel c 
unit uu. 

System Action: The system waits for the operator’s response. 
Programmer Response: None. 

Operator Response: Mount the next tape volume on the active 
tape device, the FROMDEV device. Press the interrupt key on 
the console to continue the program. Refer to Appendix A, 
“Use of Interrupt Key” on page 75 for information on 


interrupt key usage in stand-alone environments. 


Problem Determination: None. 
ADRS563A END OF JOB. 
Explanation: A normal end-of-job condition occurred. 


System Action: The job is ended. 
Programmer Response: None. 
Operator Response: None. 
Problem Determination: None. 
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“ADRS65A “ATTEMPT TO RESTORE TO WRONG | 


DEVICE. JOB TERMINATED. 
Explanation: The program attempted to restore data to a 
device type other than the type from which it was dumped. 
System Action: The job is ; ene ce 
Programmer Response: coable user error. Correct the 
TODEV operand to reflect the device from which the data was 
dumped, and rerun the job. 
Operator Response: None. 
Problem Determination: Table I, items 2, 15, 20, 28, Ree 29. 


nt Ca 


ADRS68I TRACK 0 HAS AN ALTERNATE ASSIGNED. 
THIS VOLUME HAS BECOME 
NON-IPL-ABLE 

Explanation: Track 0 was flagged as a defective track. (This 
volume is usable as a work volume but may not be usable as a 
system residence volume.) 

System Action: The job is ended. 

Programmer Response: None. 

Operator Response: If the volume is to be used as an [PLable 
volume, try IPLing from that volume. If it fails, mount 
another volume and rerun the job. 

Problem Determination: None. 


ADRS69A PRINTER EQUIPMENT CHECK. CORRECT 
ERROR. DEPRESS INTERRUPT KEY. 
Explanation: A printer equipment check occurred. 
System Action: The systern waits for the operator’s response. 
Programmer Response: None. 

Operator Response: Correct the error at the printer. Press the 
interrupt key and continue orocessing. Refer to Appendix A, 
“Use of Interrupt Key” on page 75 for information on 
interrupt key usage in stand-alone environments. 

Problem Determination: Ta>ie I, item 30. 


ADRS70A SEQUENCE ERROR ON RESTORE TAPE. 
JOB TERMINATED. 

Explanation: The restore -2se has a missing, incorrect, or 
extra record. 

System Action: The program is unable to continue with the 
RESTORE. The job is ended. 

Programmer Response: Ncnre. 

Operator Response: Protazie error during DUMP. 
Problem Determination: Tabie I, items 11, 20, 28, and 29. 


ADRS71I TRACK NOT RESTORED DUE TO !/O 
ERROR DURING DUMP, TRACK cchh 
Explanation: An I/O error was encountered in reading the 
track during DUMP. 

System Action: The track on the disk is not written on. 
Programmer Response: Ver:ry that the track is not necessary. 
Operator Response: Nore. 

Problem Determination: Ncne. 


ADR601W COMMAND REJECT. device, opcode, status, 
sense bytes 

Explanation: The specified channel rejected an incorrect 
channel command word (CCW) list. 

System Action: The job is ended. 

Programmer Response: None. 

Operator Response: Rerun the program. 

Problem Determination: Table [, items 1! and 29. 





ADR602A. -: INTERV. REQUIRED. cuu 200% fever 
Explanation: The device on channel c, unit uu, is not bready: 
‘System Action: The system waits for the operator’s response. 
Programmer Response: None. 
Operator Response: The specified device requires operator 
intervention to ready it. If for no apparent reason the device is 
not ready, initiate the following problem determination. 
Problem Determination: Table I, item 30. : 


“4 ‘ Cia Bobet 


ADR603W BUS OUT CHECK. c 

Explanation: A bus out check occurred on channel c. 
Probable hardware error. 

System Action: The job is ended. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, items 12 and 30. 


ADR604W EQUIPMENT CHECK. 

Explanation: An equipment failure occurred. Probable 
hardware error. 

System Action: The job is ended. 

Programmer Response: None. 

Operator Respense: None. 

Problem Determination: Table I, item 30. 


ADR605W DATA CHECK. ENICE, opcode, statis, sense 
bytes 

Explanation: A solid data check occurred on the specified 

device. Probable hardware error. 

System Action:’ The job is ended. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: Table I, item 30. 


ADR606W OVERRUN. c 

Explanation: An overrun check occurred on the specified 
channel. 

System Action: The job is ended. 

Programmer Response: None. 

Operator Response: Rerun the program. 

Problem Determination: Table I, item 30. 


ADR608W DATA CONV. CHECK. device, opcode, status, 
sense bytes 

Explanation: A data converter check occurred on the specified 

device. 

System Action: The job is ended. 

Programmer Response: None. 

Operator Response: Move data to another device, and rerun 

the job. 

Problem Determination: Table I. item 30. 


ADR609W END OF CYLINDER. device, opcode, status, 
sense bytes 

Explanation: An unusual end-of-cylinder condition occurred on 
the specified device. 

System Action: The job is ended. 

Programmer Response: None. 

Operator Response: Rerun the job. 


Problem Determination: Table I, item 30. 
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ADR610W INVALID ADDRESS. device, opcode status, 

sense bytes, cchh 

- Explanation: ‘An invalid address was issued to the specified — 
device. - 
System Action: The job is ended. 
Programmer Response: None. 
Operator Response: Determine if the cchh address shown in 
the message is valid for the indicated device. 

- Problem Determination: Table I, items 2, 13, and 29. 





ADR611W NOT AVAILABLE. device, opcode, status, sense 
bytes 

Explanation: The specified device is not attached to the system. 
System Action: The job is ended. 

Programmer Response: None. 

Operator Response: Ensure that the ENABLE/DISABLE 
switch on the device and/or the tape control is in the ENABLE 
position. 

Problem Determination: Table I, item 30. 


ADR612W READ DATA CHECK. device, opcode, status, 
sense bytes 

Explanation: A permanent read data check was detected on 
the specified tape unit. 

System Action: The job is ended. 

Programmer Response: None. 

Operator Response: Clean the read/write heads of the tape 
unit, and rerun the job. 
Problem Determination: Table I, item 30. 





ADR614W TRACK OVERRUN. 

Explanation: A track overrun condition occurred. 
System Action: The job is ended. 

Programmer Response: None 

Operator Response: Rerun the program. 
Problem Determination: Tabie I, items 1! and 29. 


ADR616I ASYN UC 

Explanation: DFDSS received an interrust containing a unit 
check to a device for which a Start I/O was initiated but not 
started. 

System Action: The task is terminated. 

Programmer Response: None. 

Operator Response: Rerun the job. 

Problem Determination: Table I, items 11 and 29. 


ADR617W NO RECORD FOUND 

Explanation: Two index marxers were ce:ected during a CCW 
chain, and the record being sought was nei found. 

System Action: The job is ended. 

Programmer Response: None. 

Operator Response: Probabie nardware error. Execute Device 
Support Facilities to reinitialize tne DASD volume. Rerun the 
job. 

Problem Determination: Tabie I, item 39. 


ADR618W INDETERMINATE ERROR. 

Explanation: An indeterminate I/O error occurred. 

System Action: The job is ended. 

Programmer Response: None. 

Operator Response: Verify that the control unit and channel 
are not shared. Rerun the program. 

Problem Determination: Table I, item 29. 
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Problem Determination: Table I, item 29. 


- ADR619W .-:» UNEXPECTED ERROR. device, opcode, status, 


sense bytes 
Explanation: The error return is valid, but it is not associated 
with the specified device. 
System Action: The job is ended. 
Programmer Response: None. 
Operator Response: Rerun the program. 





ee 
CHAN. CTRL ERROR. cxx, opcode, status, 
sense bytes 

Explanation: A channel control check occurred on the channel 
specified by cxx. 

System Action: The job is ended. 

Programmer Response: None. 

Operator Response: Probable hardware error. Rerun the job. 
Problem Determination: Table I, items 12 and 30. ~~ 


TO pe eta ate 


ADR620W 





ADR621W INTERFACE ERROR. cxx, opcode, status, 
sense bytes 
Explanation: An interface control check occurred on the 


channel specified by cxx. 


- System Action: The job is ended..." 0 ee 


Programmer Response: None. 
Operator Response: Probable hardware error. Rerun the job. 
Problem Determination: Table I, items 12 and 30. 


CHAN. DATA CHECK. cxx, opcode, status, 
sense bytes 

Explanation: A channel data check occurred on the channel 
specified by cxx. 

System Action: The job is ended. 

Programmer Response: None. 

Operator Response: Probable nardware error. Rerun the job. 
Problem Determination: Table {, items 12 and 30. 


ADR622W 


ADR624W PROGRAM CHECK. 

Explanation: A orogram check occurred because of an 
incorrect CCW. 

System Action: The job is ended. 

Programmer Response: None. 

Operator Response: Rerun the program. 

Problem Determination: Table I, items 11, 13, 20, and 29. 


ADR625W PROTECTION CHECK. (device, cuu), opcode, 
status, sense bytes 

Explanation: A crotection checx occurred on the specified 
device. 

System Action: The job is ended. 

Programmer Response: None. 

Operator Response: Rerun the crogram. 

Problem Determination: Table [, items 11 and 29. 


ADR626W UNIT EXCEPTION. cuu, device, opcode, status, 
sense bytes 

Explanation: A unit exception occurred on the specified unit. 
System Action: The job is ended. 

Programmer Response: None. 

Operator Response: Rerun the program. 


Problem Determination: None. 





ADR627W INCORRECT LENGTH. cuu, opcode, status, © 
sense bytes 

Explanation: An incorrect length record condition occurred on 
the specified unit. 

System Action: The job is ended. 

Programmer Response: None. 

Operator Response: Rerun the program. 


_ Problem Determination: Table I, item 29. ..; 


ADR628W CHAINING CHECK. cxx, opcode, status, sense 
bytes 

Explanation: A chaining check occurred on the channel 
specified by cxx. 

System Action: The job is ended. 

Programmer Response: Nene. 

Operator Response: Probable hardware error. Rerun the job. 
Problem Determination: Table I, items 11 and 30. 


ADR629W COMMAND SEQ. ERR. 

Explanation: An invalid sequence of CCWs was issued. 
System Action: The job is ended. 

Programmer Response: None. ; 

Operator Response: Probable hardware error. Rerun the job. 
Problem Determination: Table I, items 11 and 30. 


ADR630W SEEK CHECK ERROR. 

Explanation: An invalid SEEK address was issued, or a unit ~ 
maifunction caused a SEEK check. 

System Action: The job is ended. 

Programmer Response: None. 

Operator Response: Procable hardware error. Rerun the job. 
Problem Determination: Table I, items 2, 20, and 30. 


ADR632W TAPE-LOAD POINT. cuu, opcode, status, sense 


bytes 
Explanation: A tape at ioad point condition occurred on the 
specified tape unit. 
System Action: The job :s ended. 
Programmer Response: None. 
Operator Response: None. 
Problem Determination: Table [, items 11 and 30. 


ADR633W NOISE RECORD. cuu, opcode, status, sense 
bytes 

Explanation: A noise record was found on the specified tape 
unit. 

System Action: The job :s ended. 

Programmer Response: None. 

Operator Response: Clean the read. write heads of the tape 
unit, and rerun the job. 

Problem Determination: Table I, items 28 and 30. 


ADR634W MISSING ADR-MARK. cuu, opcode, status, 
sense bytes 

Explanation: A missing 2ddress marxer occurred on the 
specified device. 

System Action: The job is ended. 

Programmer Response: None. 

Operator Response: Rerun the job. 

Problem Determination: Table [, item 30. 


RESTORE TERMINATED. OUTPUT 


ADR635W - 
DEVICE (cccc) TOO SMALL FOR INPUT 
(cece) a 
Explanation: The number of cylinders on the target DASD 
volume is less than either: 


¢ The number of cylinders dumped from the original input 
volume _ 


° The highest cylinder number to be restored, as specified on 
a VDRL statement. 


System Action: The RESTORE operation is ended. 
Programmer Response: Supply an appropriate volume that 
matches the input for a full volume RESTORE, or correct the 
VDRL statement and rerun the job. 

Operator Response: None. 

Problem Determination: Table I, items 2 and 29. 


ADR642W INVALID TRK FMT. cuu, opcode, status, sense 
bytes 

Explanation: An attempt was made to write data exceeding 
track capacity on the specified device. 

System Action: If the input tape contains the invalid track, the 
RESTORE continues. Otherwise, the job is ended. — 
Programmer Response: None. 

Operator Response: Rerun the program. 


Problem Determination: Table I, items 11 and 29. 


ADR643W 3 WRITE INHIBITED. 

Explanation: The WRITE INHIBIT switch is probably on in 
the control unit to inhibit processing of write commands. ~ 
System Action: The job is ended. 

Programmer Response: None. 

Operator Response: Check the status of the WRITE INHIBIT 
switch: 


* [f the WRITE INHIBIT switch is on to inhibit execution 
of write commands and the disk pack should be written on, 
set the switch off and rerun the job. 


* If the WRITE INHIBIT switch is set on to intentionally 
inhibit processing of write commands, follow the 
procedures established by your installation. 


* If the WRITE INHIBIT switch is off to allow processing 
of write commands, rerun the job. 


Problem Determination: Table I, items 2, 13, and 30. 


ADR649W I/O ERROR, JOB TERMINATED. 
Explanation: This message follows all messages that describe 
input/output error conditions. 

System Action: The job is ended. 

Programmer Response: None. 

Operator Response: None. 

Problem Determination: None. 


ADR655I ADDITIONAL SENSE xxxxxxxx (XXXXXXXX ....) 
Explanation: If the device supplies more than 24 bytes of sense 
data, the additional bytes, beginning with byte 25, will be 
printed in groups of six up to the 64th byte. 

System Action: See previously issued message. 

Programmer Response: See previously issued message. 
Operator Response: None. 

Problem Determination: See previously issued message. 
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As a DFDSS user, you determine whether you or IBM is responsible for resolving a 
problem. You do this by using IBM Piocee ures to identify a failing hardware unit 


or ie dee i 


ner ae ae eee ar} Sees oe Paes 
. pee ane ee * See ae 


In most instances, one or more numbers appear cated the headin? cpisbied 
Determination,” for a given message or code. These numbers refer to the numbered 
items that appear in Problem Determination Table I, and they require you to take 
specific actions before calling IBM for support. 


Table I. Standard Problem Determination Actions 


Note: Table I contains only procedures applicable to determining DFDSS errors. 
For additional diagnosis information, see the appropriate manuals listed in “DFDSS 


__ Books” on page Vi. 


of 


4 
yan 
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Ensure that MSGLEVEL= 0 ie was 's epecified i in the JOB taienent” 


. Save the console sheet from the primary console. In systems with Multiple 
. Console Support (MCS), save a copy of the hard-copy log. 


. Save the job stream associated with the job. 


. Save the system output (SYSOUT) associated with the job. 


5. Ensure that the failing job step includes one of the following: 


~) 


a. SYSABEND DD statement 
b. SYSUDUMP DD statement. 


. Not used. 
. Run the LISTIDR function of the AMBLIST service aid program to obtain a 


list of all members with a program temporary fix (PTF) or local fix, and save 
the output. Run the program against the: 


a. SYSI.LINKLIB data set 
b. SYSI.SVCLIB data set 
c. Library containing the program that issued the message. 


. Not used. 
. Not used. 
10. 
ime 


Not used. 


Run the AMDSADMP service aid program to dump the contents of real 
storage and page data sets on magnetic tape. After restarting the system, run 
the GO function of the AMDPRDMP service aid program to print the real 
storage portion of the dump tape produced by AMDSADMP. Save both the 
tape fom AMDSADM*P (in case further information from the tape is required) 
and the listing from AMDPRDMP. 


. Run the SEREP program, and save the resulting output. 
. Save all the associated output. 


. In the normal response to this message, the programmer/operator was requested 


to run a specific program. Save all output from that program. 
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23. 
24. 
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Ob. Stage I i. 
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. Save the program. listing associated with the job... oestrone es 
. Not used. 


. Have the system generation (SYSGEN) output available from: 


a. Stage I 





Not used. 

Not used. 

Save the control statements associated with the job. 

Not used. 

Not used. 

Not used. 

Not used. 

Run the IEHLIST systern utility program to obtain a ist of the: 


a. Volume table of contents of the associated volume by specifying ii. 
FORMAT option 


b. Volume table of contents of the associated volume by specifying the DUMP 
option 


‘c. Directory of the associated data set 
d. System catalog. 


Run the Access Method Services LISTCAT ALL command to lst the source 
and target catalog entries. 


. Not used. 


Save the associated volume. 


. Contact IBM for programming support. 
. Contact IBM for hardware support. 
. Not used. 


Not used. 


Not used. 


4+. Not used. 


. Rerun the job with the parameter ABEND = nnn, where nnn its the three-digit 


message number on which the dump must be taken, and insert a SYSUDUMP 
DD statement in the JCL. This causes a User 0001 abend at the time the 
message ADRnnnx is issued. (Not applicable to stand-alone DFDSS restore 
messages.) 


Run the DIAGNOSE command of Access Method Services to determine the 
cause of the error on the: 


a. VVDS on the volume 
b. Data set on the volume and the catalog. 


(Not applicable to stand-alone DFDSS restore messages.) 
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Some of the Stand-alone DFDSS Restore Messages and Operator Response 
descriptions in Chapter 3, ‘Stand-Alone DFDSS Restore Messages” on page 67 
refer to the interrupt. key. Depending on the environment in which ou are = PUDINE, 


- the required action varies as described below.: 


Stand-alone Restore Environment 


In the native mode (real stand-alone), you press the external interrupt key on the 
processor console. The processor console is the console from which you IPLed the 
stand-alone restore program. . 


Stand-alone Restore in VM Environment 


e 


When running the Stand-alone DFDSS Restore program in a VM environment, | 
you do the equivalent of pressing an external interrupt key. This is accomplished by 
issuing the VM CP command, EXTERNAL, from the same console that you are 
using to send commands to the stand-alone restore program. (In VM, you do 
everything from the same console.) The EXTERNAL command can be executed 
by entering: 


#CP EXTERNAL 


The #CP 1s entered to ensure that the processor (VM) receives the command and 
doesn’t pass it along to the stand-alone restore program. If stand-alone restore is in 
full-screen mode, you may have to press PAI to put the terminal into CP READ 
mode before issuing the EXTERNAL command. This information 1s documented 
in Vi SP CP General User Command Reference. 
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Glossary 


This glossary includes definitions of some terms found in 
this document. Some of the terms and definitions are 
taken from Dictionary of Computing, copyright 1987 by 


: ‘International Business Machines Corporation. - It can be poe 


obtained from IBM under Form Number SC20-1699. 


Some of the terms defined are taken from: 


¢ The American National Standard Dictionary for 
Information Systems,ANSI X3.172-1990, copyright 
1990 by the American National Standards Institute 
(ANSI). Copies may be purchased from the 
American National Standards Institute, 1430 
Broadway, New York, New York 10018. 
Definitions are identified by the symbol (A) after the 
definition. 


* The Jnformation Technology Vocabulary, developed 


by Subcommittee 1, Joint Technical Committee 1, of 


the International Organization for Standardization 
and the International Electrotechnical Commission 
(ISO/IEC JTC1/SC1). Definitions of published 
parts of this vocabulary are identified by the symbol 
(1) after the definition; definitions taken from draft 
international standards, committee drafts, and 
working papers being developed by ISO/IEC 
JTC1/SC1 are identified by the the symbol (T) after 
the definition, indicating that final agreement has 
not yet deen reached among the participating 
National Bodies of SCl. 


A 


ABEND. Abnormal end of task. End of a task, a job, 
or a subsystem because of an error condition that 
cannot be resolved by recovery facilities while the task is 
performed. 


ABENDxxx. The keyword that identifies the abnormal 
end of DFDSS because of a syster-detected error. 


ABSTR. A suodparameter of the SPACE parameter in 
a DD statement. It indicates that specified tracks be 
assigned to a data set. 


ACCEPT processing. An SMP/E process necessary for 
installing the FMIDs. SMP/E ACCEPT processing uses 
JCL to accept the modules and macros necessary to run 
the FMIDs. The FMIDs are accepted into the DLIBs 
from the temporary data sets. 


Access method services. A multifunction service 
program that is used to manage both VSAM and 
non-VSAM data sets and integrated catalog facility or 
VSAM catalogs. It is used to define data sets and 
allocate space for them, convert indexed-sequential data 
sets to key-sequenced data sets, modify data set 
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attributes in the catalog, reorganize data sets, facilitate 
data portability between operating systems, create 
backup copies of data sets, data set records and catalog 


entries. help make inaccessible data sets accessible, list . 
“the records of data sets and catalogs, ‘define and build 


alternate indexes, and convert OS CVOLs and VSAM 
catalogs to integrated catalog facility catalogs. 


ACDS. Active control data set. ° 
ACS. Automatic class selection. . 
AIX. Alternate index. 


alias. An alternate name for a member of a partitioned 
data set. 


*ALLOC. A space allocation parameter that indicates 


type, such as cylinders or tracks. 


alternate index (AIX). In systems with VSAM, a 
key-sequenced data set containing index entries 
organized by the alternate keys of its associated base 
data records. It provides an alternate means of locating 
records in the data component of a cluster on which the 
alternate index is based. 


alternate index cluster. In VSAM, the data and index 
components of an alternate index. 


APAR. Authorized Program Analysis Report. 


Authorized Program Analysis Report (APAR). A 
request for correction of a problem caused by a 
suspected defect in a current unaltered release of a 
program. 


APF. Authorized program facility. 


Application Interface. An interface used to invoke 
DFDSS from another program. 


Apply processing. In SMP and SMP/E, the process, 
initiated by the APPLY command, that places system 
modifications (SYSMODS) into the target system 
libraries. 


attach. In programming, to create a task that can be 
performed asynchronously with the performance of the 
mainline code. 


authorization. (1) (C97) The right granted to a user to 
communicate with or make use of a computer system. 
(2) The process of giving a user either complete or 
restricted access to an object, resource, or function. 


automatic class selection (ACS). A mechanism for 
assigning SMS classes and storage groups. 
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“ - ao ‘CDE. Contents directory entry. 
base cluster. In systems with VSAM, a key-sequenced 


or entry-sequenced data set over which one or more - CDS. Control data set. 
alternate indexes are built. 


channel command word (CCW). A doubleword at the 
3 »» location. i -in. main storage specified .by the channel. . 

address word. One or more CCWs make up he” : 

channel program that directs data channel operations. 


basic, catalog structure (BCS). The name of the catalog . 
“structure in the. integrated: catalog” facility environment. ~~ 
An integrated catalog facility catalog consists of a BCS 

and its related VSAM volume data sets (VVDSs). 





ee oe CI. Control interval. 
basic direct access method (BDAM). An access method 


used to directly retrieve or update particular blocks of a CLIST. Command list. 
data set on a direct access device. 


component identification keyword. The first keyword, 
represented as a number, in a set of keywords used to 
describe a DFDSS program failure. 


basic partitioned access method (BPAM). An access 
method that can be applied to create program libraries 
in direct access storage for convenient storage and 


retrieval of programs. COMPRESS command. The DFDSS function that 
reduces partitioned data sets by taking unused apace: a8 
basic sequential access method (BSAM). An access. —-_ consolidating it at the end of the data set. 


‘method for storing or retrieving data blocks in a 
continuous sequence, using either a sequential access or 


: : concatenation. An operation that joins two characters 
a direct access device. 


or strings in the order specified, forming one string 
yee? - whose length is equal to the sum of the lengths of the 


BCS. Basic catalog structure. two characters or strings. 


BDAM. Basic direct access method. control interval (CI). A fixed-length area of ‘auxiliary 

. ; storage space in which VSAM stores records. It is the 
BLK. A subparameter of the SPACE parameter in a unit of information transmitted to or from auxiliary file, 
DD statement. It specifies that space is allocated by storage by VSAM. 

blocks. 


control volume (CVOL). A volume that contains one or 


block length. Synonym for block size. more indexes of the catalog. 


block size. (1) (1C97) The number of data elements in 
a block. (2) * A measure of the size of a block, usually 
specified in units such as records, words, computer 


words, or characters. (3) Synonymous with block CONVERTV command. The DFDSS function that 
length. converts volumes to and from Storage Management 
Subsystem management without data movement. 


constructs. A collective name for data class, storage 
class, management class, and storage group. 


BPAM. Basic partitioned access method. 


COPY command. The DFDSS function that performs 


bpi. bits per inch. data sets, volumes, and tracks movement. 


BSAM. Basic sequential access method. CP. Control Program. 


Cc CREDT. Creation date. 


call. (ISO) * The action of bringing a computer CSW. Channel status word. 


program, a routine, or a subroutine into effect, usually 
by specifying the entry conditions and jumping to an 
entry point. 


CVAF. Common VTOC access facility. 


CVOL. Control volume. 


card image. * A one-to-one representation of the hole 
patterns of a punched card; for example, a matrix in 
which a one represents a punch and a Zero represents 
the absence of a punch. 


CVT. Communication vector table. 


CYL. A subparameter of the SPACE parameter in a 
DD statement. It specifies that space is allocated by 


CCHHR. Cylinder, cylinder, head, head, record. cylinders. 
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DADSM. The direct access space management 
program that maintains the VTOC, VTOCIX, and space 
on a volume. 


., DAM. Direct access method. o.oo je oce poceg oe eee 


See et Oe 
oe r 


DASD. Direct access storage device. 
DASD ERP. DASD error recovery procedure. 


data class. A list of data set allocation parameters and 
their values that are used when aliceating anew 
SMS-managed data set. 


data compression (run-length). A method of encoding 
repetitive series of identical characters so that they 
occupy less space on a dump tape. Data compression is 
supported oye a i ss ane eran pee 
processing. | 


Data Facility Data Set Services (DFDSS). A DASD 
data and space management tool for backup and 
recovery, Space management functions, and copying — 
data between like and unlike devices. DFDSS is the 
primary data mover of the Data Facility family. 


Data Facility family. A family of products, consisting of 
DFP, DFDSS, DFHSM, and DFSORT, that performs 
key data and storage management functions. 


Data Facility Hierarchical Storage Manager 
(DFHSM). A facility that automates space and 
availability management by backing up and migrating 
data within a hierarchy of storage. 


Data Facility Product (DFP). The key architectural 
component of the Storage Management and non-Storage 
Management Subsystem environments. DFP manages 
programs, data, and devices in the MVS environment. 


Data Facility Sort (DFSORT). A data and storage 
management tool that handles sorting, merging, and 
copying applications. 


Data Facility Storage Management Subsystem 
(DFSMS). The complementary functions of MVS/DFP 
and other individual products of the Data Facility 
family, which, together with RACF provide a 
system-managed, administrator-controlled storage 
environment. 


data set backup. Backup to protect against the loss of 
individual data sets. 


data set change indicator. A bit that is set by OPEN 
when the data set is opened for processing other than 
input. This flag is supported on MVS systems that have 
data-set-changed flag support installed. 











. DAU, , Direct access ce eaBie a. , ae 


DB2*. IBM DATABASE 2. 

DCB. Data control block. 

DEFRAG command. The DFDSS function that 
consolidates the free Space on a volume to help prevent . 
out-of-space abends on new allocations. 

DEQ. An Assembler language macro instruction used 
to remove control of one or more serially reusable 
resources from the active task. 

DFDSS. Data Facility Data Set Services. 

DFHSM. Data Facility Hierarchical Storage Manager. 
DFP. Data Facility Product. 


DFSMS*. Data Facility Storage Management _ 


Subsystem ~~ 


DFSORT. Data Facility Sort. 


DGTHIX50. The panel identification number for the 
DFDSS Help Index. It is used to verify that 
DFDSS/ISMF is installed correctly. 


DIAGNOSE. An access method services command 
that scans an integrated catalog facility basic catalog 
structure (BCS) or a VVDS to validate the data 
structure. 


DIRF. DADSM interrupt recording facility. Ifa 
system fails, or a permanent I/O error occurs during 
allocation of space or during performance of a routine 
that updates the VTOC, the VTOC may be in error. To 
ensure that an error is recorded, the DADSM routines 
turn on a bit in the VTOC upon entry to a DADSM 
function, and, if no errors occur during processing, turn 
off that bit upon exiting from that function. 


distribution libraries. IBM-supplied partitioned data sets 
on tape containing one or more components that the 
user restores to disk for subsequent inclusion in a new 
system. 

DLIB. Distribution library. 

DOC. In diagnosing program failures, the keyword 
that identifies an error in the documentation of a 
program. 


DOS. Disk Operating System. 


DOS bit. On a volume without an indexed VTOC, a 
bit that indicates that the free space map is invalid. 


DOS/VSE. DOS/Virtual Storage Extended. 


DSCB. Data set control block. 
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filtering. It indicates that the data set is to be selected if 
‘the data set has been changed. 5% 


dsn. Data set name 
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DUMP command. The DFDSS function used to back 
up data sets, tracks, and volumes. 


dynamic allocation. Assignment of system resources to 
a program when the program is performed rather than 
when it is loaded main storage. 


Early Warning System (EWS). A microfiche copy of 
the information contained in the Software Support 
Facility (SSF), organized by component identification 
number and indexed by APAR symptom code. EWS is 
published monthly and available to customers of IBM 


ucenice eee 


ECB. Eveai Pree block. 


EC mode. Engineering change mode. 


empty data set. A data set in which the pointer to the 
last-used block is 0. 


ENQ. An Assembler language macro instruction that 
requests the control program to assign control of one or 
more serially reusable resources to the active task. It is 
also used to determine the status of a resource; that is, 
whether it is immediately available or in use, and 
whether control has been previously requested for the 
active task in another ENQ macro instruction. 


entry-sequenced data set (ESDS). In VSAM, a data set 
whose records are loaded without respect to their 
contents and whose RBAs cannot change. Records are 
retrieved and stored by addressed access, and new 
records are added at the end of the data set. 

EOF. End-of-file. 

EOJ. End of job. 

ESDS. Entry-sequenced data set. 

ESTAE. Extended specify task abnormal exit. 

EQ. Equal to. 

EWS. Early Warning System. 


EXCP. Execute channel program. 
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EAST 


_. Execute channel program (EXCP). . A macro. used to 
access a data set without specifying the organization. 


EXPDT. Expiration date. 


Extended specify task abnormal exit (ESTAE), A task 
recovery routine that provides recovery for those 


ea CEA ciate programs. that run enabled, unlocked, and in task.mode. ...... 
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extent. A continuous space on a DASD volume 
occupied by a data set or portion of a data set. An 
extent of a data set contains a whole number of control 
areas. 


E 


FC. CVAF function code. 

FCEC. CVAF function-error code. 

filtering. ‘The process of selecting data’sets based on - 
specified criteria. These criteria consist of fully- or 
partially-qualified data set names and/or of certain data 
set characteristics. 


FMID. Function modification identifier, 


fully-qualified data set name. A data set in which ail the 
qualifiers are completely spelled out. 


function modification identifier (FMID). A code that 
identifies the release levels of a program product. 


FVL. function vector list. 


G 


GDG. Generation data group. 
GDS. Generation data set. 


Generation data group (GDG). A collection of 
historically related non-VSAM data sets that are 
arranged in chronological order; each data set is a 
generation data set. 


Generation data set. 
data group. 


One generation of a generation 


GT. Greater than. 


| 
ICKDSF. Device Support Facilities. 
IDCAMS. Access Method Services. 


IMS/VS. 
Storage. 


Information Management System/Virtual 
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-INCORROUT. In diagnosing program failures, the 
keyword that identifies incorrect or missing program 
output. 


incremental backup. A process in which data sets are 
backed up only if they have changed since their last 
osgae 20 
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Installation-wide exit. The means specifically described 


in an IBM software product’s documentation by which 
an IBM software product may be modified by a 
customer’s system programmers to change or extend the 
functions of the IBM software product. Such 
modifications consist of exit routines written to replace 
one or more existing modules of an IBM software 
product, or to add one or more modules or subroutines 
to an IBM software product, for the purpose of 
modifying (including extending) the functions of the IBM 
software 


integrated catalog facility. A facility by which VSAM 
data set volume-related fields are separated from the 
catalog and maintained in the VVDS on the volume on 
which the data set resides. 


Interactive Storage Management Facility (ISMF). A 


DFP component that provides an interactive interface to . 


DFDSS and DFHSM. ISMF uses menu-driven panels 
to build jobs streams for most DFDSS functions. 
DFDSS/ISMF performs the following functions: 
COMPRESS, CONVERTV, COPY, DEFRAG, 
DUMP, RELEASE, and RESTORE. 


Interactive System Productivity Facility (SPF). An 
IBM licensed program used to develop, test, and run 
application programs interactively. ISPF is the 
interactive interface for all storage management 
functions. 

1/O. Input/output. 

IPL. Initial program load. 

ISMF. Interactive Storage Management Facility. 
ISAM. Indexed sequential access method. 

ISMF. Interactive Storage Management Facility. 


ISPF. Interactive Systems Productivity Facility. 


ISPF/PDF. Interactive Systems Productivity 
Facility/Program Development Facility. 
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JCL. Job control language. 


JES. Job entry subsystem. 


wt > JES2, -An MVS subsystem that receives. jobsinto the 
system, converts them to internal format, selects them 


for operation, processes their output, and purges them 
from the system. In an installation site with more than 
one processor, each JES2 processor independently 
controls its job input, scheduling, and output processing. 


JES3. An MVS subsystem that receives jobs into the 
system, converts them to internal format, selects them 
for operation, processes their output, and purges them 
from the system. In complexes that have several 
loosely-coupled processing units, the JES3 program 
Manages processors so that the global processor 
exercises centralized control over the local processors 


“and distributes jobs to them via a common job queue. 


JFCB. Job file control block. 


"job control language (JCL). A problem-oriented 


language used to identify the job or describe its 
requirements to an operating system. 


job entry subsystem (JES). A system facility for 
spooling, job queuing, and managing !/O. 


JSCB. Job step control block. 


K 

KB. Kilobyte (1 024 bytes). 

key-sequenced data set. A VSAM file or data set whose 
records are loaded in ascending key sequence and 
controlled by an index. Records are retrieved and 
stored by keyed access or by addressed access, and new 
records are inserted in key sequence by means of 
distributed free space. Relative byte addresses can 


change because of control interval or control area splits. 


keyword. A symptom that describes one aspect of a 
program failure. 


KSDS. Key-sequenced data set. 


L 

LASTCC. Last condition code. 

LDS. Linear data set. 

like devices. Devices that have the same track capacity 


and number of tracks per cylinder (for example, 3380 
Standard and 3380 Model J or K). 
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LINK. An Assembler language macro instruction that 
causes control to be passed to a specified entry point. 
The linkage relationship established is the same as that 
created by a BAL instruction. 


link-pack area (LPA). An area of virtual storage that 
contains re-enterable routines that are loaded at IPL 


: Gnitial program toad) time‘and can be used concurrently’ 


by all tasks in the system. 


load module. (TC97) A computer program in a form 
suitable for loading into main storage for operation. 


load module library. A partitioned data set used to store 
and retrieve load modules. . 


logical (data set} DUMP operation. A DUMP 
operation in which logical processing is performed. 


logical (data set) processing. Processing that treats each 
-, data set-and its associated information as a logical . 
entity. As an ‘example, DFDSS processes an entire data 
set before beginning with the next one. 

- logical (data set) RESTORE operation. A RESTORE | 
operation that uses as input a data set produced by a 
logical DUMP operation. 

logical volume. The output produced from a physical 
DUMP operation, for which all data is derived from a 
single DASD volume. 

LOOP. In diagnosing program failures, the keyword 
that identifies a program failure in which some part of 
the program repeats endlessly. 

LPA. link-pack area. 

LT. Less than 

LRECL. Logical record length. 


LVOL. logical volume. 


M 


maintenance-level keyword. In diagnosing program 
failures, a keyword that identifies the maintenance level 
of DFDSS. 

management class. A list of the migration, backup and 
retention parameters and their values for an 
SMS-managed data set. 


map record. The record that maps the tracks that were 
dumped by DFDSS. 


MAXCC. Maximum condition code. 


MCS. Multiple Console Support. 
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minivolume. In an MVS system running on VM/370, an 
OS/VS-formatted VM/370 minidisk whose size is. equal 
to or less than that of the real volume. DFDSS uses the 
device size specified in the in their VTOC. Minivolumes 
are kins dito oat Wk the ay version of DF DSS: 


tt ty areas SS oe - pe on ey 4 we ee me 
MSGADRnnnt, in dieanonte program failures, the 
DFDSS message keyword that tells of an error, or 
seems itself to be in error. 





MSS. Mass storage system. 


MVS. Multiple virtual storage. 


N 


NVR. Non-VSAM volume record. 
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Operating System (OS). Software that controls the 


execution of programs; an operating system may provide 


services such resource allocation, scheduling, 
input/output control, and data management. __ 


OS. Operating System. 


OS/VS2. Operating System/Virtual Storage 2. 


p 


pageable link-pack area (PLPA). Link-pack area. 
PAM. Partitioned access method. 


partially-qualified data set name. A data set name in 
which the qualifiers are not spelled out. Asterisks and 
percent signs are used in place of the undefined 
qualifier(s). 


partitioned data set (PDS). A data set in direct access 
storage that is divided into partitions, called members, 
each of which can contain a program, part of a 
program, or data. 


partitioned data set extended (PDSE). A 
SMS-managed, page-formatted data set on direct access 
storage. A PDSE contains an indexed directory and 
members similar to the directory and members of 
partitioned data sets. A PDSE can be used instead of a 
partitioned data set. 


PDS. Partitioned data set. 
PDSE. Partitioned data set extended. 


PERFM. In diagnosing program failures, the keyword 
that identifies degradation in program performance. 








physical (data set) DUMP. operation... A DUMP .... 
operation in which physical processing is performed. 


physical (data set) processing. Processing that moves 
data at the track-image level and can operate against 
volumes, tracks, and data sets. As an example, DFDSS 


may ony Process one volume of a ulus data set. 
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| ‘PLPA. Pageable link- -pack area. 
POU. Partitioned organization unmovable. 
PRB. Program request block. 


private library. A user-owned library that is separate 
and distinct from the system library. 


PSU. Physical sequential unmovable. 
PSW. Program status word. 


PTF. Program temporary fix. 


Q 


QSAM. Queued sequential access method. 


qualified name. A data set name consisting ofa string 
of names separated by periods; for example, 
“TREE.FRUIT.APPLE” is a qualified name. 


qualifier. Each component name in a qualified name 
other than the rightmost name. For example, “TREE” 
and “FRUIT” are qualifiers in 
“TREE.FRUIT.APPLE.” 


Queued sequential access method (QSAM). An 
extended version of the basic sequential access method 
(BSAM). Input data blocks awaiting processing or 
output data blocks awaiting transfer to auxiliary storage 
are queued on the system to minimize delays in I/O 
operations. 


R 


RACF. Resource Access Control Facility. 
RB. Request block. 

RBA. Relative byte address. 

RDJFCB. Read job file control block. 


RECEIVE processing. An SMP/E process necessary to 
install new product libraries. During this process, the 
code, organized as unloaded partition data sets, is 
loaded into temporary SMPTLIB data sets. SMP/E 
RECEIVE processing automatically allocates the 
temporary partitioned data sets that correspond to the 
files on the tape, and loads them from the tape. 
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RECFM. Record format. »... . 


REFDT. A DFDSS keyword used in BY “Iter: It 
indicates the last-referenced date. 


relative byte address (RBA). The displacement 
(expressed as a fullword binary integer) of a data record 


or a control interval: frony the beginning of. thé'data: ‘set . 


to which it belongs, independent of the manner in which 
the data set is stored. 


Relative record data set (RRDS). A VSAM data set 
whose records are loaded into fixed-length slots. 


RELEASE command. The DFDSS function that 
releases the unused space in sequential and partitioned 
data sets for use by other data sets. 


RESERVE. A method of serializing DADSM update 
accesses to the VTOC. It is also a method of ne 
Proceso accesses to a shared, eae yolume... 

Resource Access 5 Control F acility (RACF). ie : IBM 
program product that provides for access control by 


_identifying and verifying users to the system, authorizing 


access to DASD data sets, logging the detected 
unauthorized attempts to enter the system, and logging 


- the detected accesses to protected data sets. 


RESTORE command. The DFDSS function used to 
recover data sets, tracks, and volumes. 


RMID. Replacement module identifier. 
RRDS. Relative record data set. 


run-length data compression. Data compression 
(run-length). 


S 


SAF. System Authorization Facility. 
SAM. Sequential access method. 


scheduler task. A DFDSS subtask that interprets and 
schedules commands. 


SCP. System control program. 
SEQ. Sequential or sequential processing 


SEREP. System environmental recording, editing, and 
printing 


SMF. System management facilities. 
SML. MVS Storage Management Library. 
SMP. System Modification Program. 


SMP/E. System Modification Program/Extended. 


Glossary $3 








ion hee Jabr ey ye Page pare ae oes a ear Rae 
ge SRE act aspen ” DA 





~- SMPE. - A cataloged procedure that includes the ~~" 


required DD statements for running SMP/E and is used 
in the RECEIVE, APPLY, and ACCEPT steps of 
’ SMP/E processing. Ss 


SMS. Suotage ee a Subsystem 


Software: ‘Siigparé Facility’ (SSF). An IBM’ oailine data 
base that allows for storage and retrieval of information 
about all current APARs and PTFs. 


SP. System Product. 


sphere. A VSAM cluster with one or more associated 
alternate indexes and paths. The VSAM cluster 
(sometimes called the base cluster), alternate indexes 
(AIXs), and paths are sometimes referred to as sphere 
components. 


SSF. Software SUEpO Laneea 

wos ORNS Hye ee 
stand-alone DFDSS pestore program. “One of two . 

DFDSS programs. Stand-alone DFDSS restore runs 

independently of the MVS system environment and is 

- limited to one function—a full or partial (tracks) . 

RESTORE from a dump tape. 


storage class. »A named list of data set storage ~~ 
attributes that SMS uses to identify performance and 
availability requirements. 


storage constructs. The group of predefined models 
(data class, management class, storage class, and storage 
group) that are used to classify storage management 
needs and procedures for data sets under the Storage 
Management Subsystem. Each data set has construct 
names associated with it by explicit specification or 
defaulting. 


storage group. A named collection of DASD volumes 
that have been grouped to meet a defined service 
strategy. 


storage management. The task of managing auxiliary 
storage resources for an installation. 


Storage Management Subsystem (SMS). An MVS 
subsystem that helps automate and centralize the 
management of storage. To manage storage. the storage 
management subsystem provides the storage 
administrator with control over data class, storage class, 
management class, storage group, and automatic class 
selection routine definitions. 


subtask. A task initiated and ended by a higher order 
task. 


SVC. Supervisor call instruction. 
SVRB. Supervisor request block. 


SYSRES. System residence disk. 
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‘system library.-:A. collection of data sets or files in oi: +.» 


which the parts of an operating system are stored. 
system link library. System library. 

System Modification Program (SMP). A program used 
2 and software oo on the MVS. 


Va 
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System Modification Program Extended (SMP/E). An 
IBM licensed program used to install software and 
software changes on the MVS system. In addition to 
providing the services of SMP, SMP/E consolidates 
installation data, allows more flexibility in selecting 
changes to be installed, provides a dialog 1 interface, and 
supports dynamic allocation of data sets. 


T 
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Time sharing option (TSO). ‘Aa spuone on the operating 
system for a System/370 that provides interactive time 


sharing from remote terminals. 


TIOT. Task input/output table. 

TLIBs. Target data sets. 

track packing. A technique used by DFDSS that builds 
target tracks for any DASD device using input physical 
record information. 

TRK. A subparameter of the SPACE parameter in a 
DD statement. It specifies that space is to be allocated 
by tracks. 

TSO. Time-sharing option. 

TSO/E. TSO/Extensions. 

TTR. track-track-record. 

type-of-failure keyword. In diagnosing program failures, 


a keyword that identifies the type of program failure that 
has occurred in DFDSS. 


U 


UACC. Universal access authority. 
UCB. Unit control block. 
UIM. User interaction module. 


unlike devices. Devices that have different track 
capacities, for example, 3350 and 3380. 


used tracks. Tracks from the beginning of data sets to 
the last-used track. 


TE 
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user exit. A programming service provided by an IBM 
software product that may be requested by an 
application program for the service of transferring 
control back to the application program upon the later 
occurrence of a user-specified event. 
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VDRL. Volume restore limits. 
VDSS. VTOC/Data Set Services. 


virtual storage access method (VSAM). An access 
method for direct or sequential processing of fixed and 
variable-length records on direct access devices. The 
records in a VSAM data set or file can be organized in 
logical sequence by a key field (key sequence), in the 
physical sequence in which they are written on the data 
set or file (entry-sequence), or by the relative-record 
number. | 


VM. Virtual machine. 
VOLID. Volume ID. 
VOLSER. Volume serial number. 


volume backup. Backup of an entire volume to protect 
against the loss of the volume. 


volume header record. The record in the DFDSS dump 
tape that identifies and contains data pertinent to the 
whole volume, and identifies the type of operation that 
created a dump. 


volume trailer record. The record in the DFDSS dump 
tape that identifies the end of the data for a DASD 
volume. 
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VRRDS. A VSAM variable record RRDS.° 
VSAM. Virtual storage access method. . 

VSAM volume data set (VVDS). A data set that | 


describes the VSAM and SMS-managed non-VSAM 
data sets on a volume. The name of the sean set is 


~- SYSL.VVDS.Wvolser. 3 6 0 


VSE. Virtual storage extended. 

VTOC. Volume table of contents. 

VTOCIX. The data set on which the location of the 
data set VTOC entries are kept in an index for quick 
access by DADSM. The name of the data set is 
SYS1.VTOCIX. Vvolser. 


VVDS. VSAM volume data set. 


. WVR. + VSAM volume record. 


W 


WAIT. In diagnosing program failures, the keyword 


that identifies DF DSS suspended activity, while waiting 
for some condition to be satisfied. DFDSS does not 
issue a message to tell why it is waiting. 


WTO. Write to operator 


X 


XA. Extended Architecture. 
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This book describes how to use’Data Facility Data Set Services (DFDSS) to perform 

various storage management tasks. It is intended primarily for system programmers. 

This book also describes functions that should _be used with the ‘interfaces provided — : 

herein. Uniess specifically stated otherwise, the information in this book must. not 2." 
be used for programming purposes. However, this book does provide the following 

type of information which is explicitly identified where they occur: 


General-Use Programming Interface: General-use programming interfaces are 
provided to allow the customer to write programs that use the services of DFDSS. 


Note: Examples provided in this publication contain sets of program statements _ aes 
offered to users as an illustration of how to obtain product service and are not to be 
used as programming interfaces. 


For information about the syntax of DFDSS commands, see Data Facility Data Set 
Services: Reference. . For information about DFDSS Messages, S see © Data Facility. . 
Data Set Services: Messages. 


Data Facility Storage Management Subsystem (DFSMS) 1 is hereafter referred to as 
Storage Management Subsystem (SMS). oe 


The following terms are trademarks of IBM and are used in this publication: 
DB2 
DFSMS 
MVS/DFP 
MVS/ESA 
MVS/SP 
MVS/XA 


Major Divisions of This Book 


This book is organized as follows: 


Chapter 1, Introduction to DFDSS presents a brief overview of DFDSS 
functions. 


Chapter 2, Requirements for Running DFDSS describes the requirements for 
running DFDSS. 


Chapter 3, Logical/Physical Processing and Data Set Filtering explains the 
differences between logical and physical processing, and how to use data set 
filtering to select data sets for DFDSS processing. 


Chapter 4, Changing Command Specifications for DFDSS Version 2 Release 5 
explains how to change the specification of commands to make a smooth 
transition to DFDSS Version 2 Release 5.0. 


Chapter 5, Invoking DFDSS explains the different ways you can invoke DFDSS. 
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‘Required Product Knowledge 


~ ~ Chapter 9, Converting Data to and from ' SMS sa Se ae ow tot use 


_. affect, DEDSS } processing... 





_ Chapter 6, Protecting DFDSS Functions discusses, how you can Protect. various oa 


‘DFDSS ‘and DFDSS/ISMF functions. 


“OO OY 


Chapter 4, Managing Availability with DFDSS describes now: tot use -DEDSS 


DUMP and RESTORE commands to fulfill your data‘availability requirements. 


Chapter 8, Managing Data Movement with DF sae describes how to use pEbss 
_ to perform. data, movement.’: See NE atts 
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DFDSS to convert data to and from Storage Management Subsystem (SMS) 
control. 


Chapter 10, Managing Space with DFDSS describes how to use DFDSS 
RELEASE, COMPRESS, and DEFRAG commands to manage DASD space. 


“Appendix “A; ACS Routine Variables lists the variables available to ACS routines 
during DFDSS COPY, RESTORE, and CONVERTV. 


Appendix B, Changing Command Specifications for DFDSS Version 2 Release 4 
explains what the new keywords were for Version 2 Release 4 and how they 
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Appendix ¢ ‘Stand-Alone Restore paca lists storage aad other ane for ie 


stand-alone DFDSS restore program. 
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To use this manual you ‘need some iciowiedae. of fhe Data Facility Product (DEP), 
Data Facility Hierarchical ‘Storage Manager (DFHSM), Resource Access Control 
Facility (RACF), and job contro! language (JCL). 


Prerequisite Books 


iV DFDSS: User’s Guide 


Data Facility Data Set Services: General Information, GC26-4123, introduces you 
to DFDSS and helps in evaluating its use. 


Data Facility Data Set Services: User’s Guide, SC26-4388, gives guidance on how 
to use DFDSS. 


Data Facility Data Set Services: Reference, SC26-4389, describes DEDSS 
command syntax. 


Data Facility Data Set Services: Messages, SC26-4390, lists DFDSS messages. 


Data Facility Data Set Services: Diagnosis Guide, LY27-9538, tells how to 
diagnose errors you might encounter while using DFDSS. 


Data Facility Data Set Services/Interactive Storage Management Facility: 
Installation Planning Guide, SC26-4129, describes considerations when you plan 
for and install DFDSS/ISMF. 
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MVS/ESA 


Long Title 
MVS/ESA Application Development Guide 


MVS/ESA Application Development Macro 
Reference 


MVS/ESA Data Facility Product Version 3: 
General Information 


MVS/ESA System Generation 
MVS/ESA Catalog Administration Guide 
MVS/ESA: Storage Administration Reference 


MVS/ESA Storage Management: Managing 
Data Sets 


Short Title 
Application Development Guide 


Application Development Macro Reference 


General Information 


System Generation 
Catalog Administration Guide 
Storage Administration Reference 


SML: Managing Data Sets 


MVS/370 Se oh giiite ee 
Long Title Short Title Order wanniiee? 
MVS/370 JCL User’s Guide JCL User’s Guide GC28-1349 
MVS/370 JCL Reference JCL Reference GC28-1350 
MVS/370 Linkage Editor and Loader User’s Linkage Editor and Loader User’s Guide GC26-4061 
Guide . ss ae i 
MYVS/370 Installation: System Genspation System Generation GC26-4063 

MVS/XA 
Long Title © : Short Title= Order Number - 
MVS/Extended Architecture JCL User’s Guide JCL User’s Guide GC28-1351 : 
MVS/Extended Architecture JCL Reference JCL Reference GC28-1352 

~ MVS/XA Version 2. 

Long Title Short Title Order Number 
MVS/Extended Architecture Linkage Editor and Linkage Editor and Loader User’s Guide GC26-4143 
Loader User’s Guide 
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GC28-1821 
GC28-1822 


GC26-4507 


GC28-1825 
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DFDSS Version 2 Release 5 ides additional storage tiatiteerticnt facilities and*” 
enhancements to help you: 


¢ Take advantage of a new type of data set. 


MVS/DFP Version 3 Release 2 now provides a specially designed data set, called 
a partitioned data set extended (PDSE). DFDSS supports the PDSE, which 
offers significant advantages over a partitioned data set (PDS). DFDSS also. 
provides new keywords to convert a PDS to a PDSE and a PDSE to a PDS. 


This support requires MVS/DFP Version 3 Release 2 or a later release. 


Use new application interface exit points. 


‘New options for application interface exits further enhance the interaction”“* 


between DFDSS and its invoking program at the data set level. DFDSS passes 
control to the user interaction module (UIM) when a data set is selected and 

when the processing of that data set is completed. At these exit points, the UIM _ 
can perform a number of tasks. For example, you can customize the UIM to ~ 
end processing of the data set or to o, bypass. options such as serialization and 
security verification. 


Process data sets with a high-level qualifier of SYS1. 
By using the PROCESS(SYS1) keyword. you can: 


— Release unused space in partitioned or sequential data sets with a high-level 
qualifier of SYS1. 


— Move data sets with a high-level qualifier of SYS1. 


—- Specify the DELETE keyword with the DUMP command to dump and 
delete data sets with a high-level qualifier of SYSI. 


— Replace preallocated data sets that have a high-level qualifier of SYS1. 
Process data sets that have undefined DSORG. 


By using the PROCESS(UNDEFINEDSORG) keyword, you can copy or 
restore undefined DSORG data sets to an unlike device that has a larger track 
capacity. 


Specify both the OPTIMIZE and COMPRESS keywords for dumps. 


You no longer must choose between performance (by specifying OPTIMIZE) or 
saving space (by specifying COMPRESS). You can back up data by using both 
keywords. 


Reduce I/O to the VVDS during logical data set DUMP/RESTORE, data set 
COPY and CONVERTV. 


Use stand-alone RESTORE to restore compressed dump data. 


Declare a larger block size for a SYSPRINT data set or the output data set from 
the PRINT command. 


DFDSS now allows a block size greater than 141. 
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Reduce CPU time by i improving the data compression algorithm during L DUMP. 
Specify the target status of SMS-managed generation data sets. 





Storage Management Subsystem (SMS) Support 


e When processing a data set, DFDSS recognizes and preserves the data, 


a 
_ @ 


management, and storage classes associated with the data set. 
COPY ‘and DUMP/RESTORE commands move data sets between SMS- and _ 
non-SMS-managed volumes. 


The new CONVERTV command converts volumes to and from SMS 
management without data movement. 


-DFDSS allows data set selection based on data, management, and storage Class’ “ 


names. 


The new INCAT keyword allows DFDSS to locate source data sets cataloged 
outside the standard search order for COPY, DUMP, and CONVERTV. This » 
keyword can be used in place of JOBCAT/STEPCAT statements, which are 
prohibited when processing SMS-managed data sets. 


Functional Enhancements 
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The new SPHERE keyword allows DFDSS to move an entire VSAM sphere 
(base cluster and all associated alternate index clusters and paths) with one 
invocation of COPY, DUMP, or RESTORE. 


DFDSS COPY and RESTORE have the capability to allocate multivolume 
VSAM target data sets. 


The % character acts as a place holder for DFDSS data set name filtering. 
DFDSS reblocks data sets that have the reblockable indicator set on. 


The REBLOCK keyword (already supported for COPY) is supported for logical 
RESTORE. . 


Multiple arguments for filtering criteria can be specified on the BY keyword. 


A new application interface exit point (EIOP20) has been added. DFDSS passes 
control to this exit when a data set is allocated by DFDSS during a physical 
data set RESTORE operation. 


When DFDSS (COPY or logical RESTORE) detects an under-allocation of the 
non-VSAM target data set, it estimates the amount of additional space needed 
and extends the data set accordingly. The copy or restore then continues, using 
the additional space. 
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Version 2 Release 3, June 1987 pte © Oe Seg oe 
Information is added to support BERS: Version 2 Release 3 praancemealss: which 
include: 


Data Facility Family enhancements. With MVS/Extended Architecture Data 
ans Product (MVS/XA DFP) Version 2 Release 3 installed: 


— The Interactive Storage Management Facility (SMF) siipports * ae 
volume-oriented functions, for example, DEFRAG and full-volume DUMP. 


v . 
vot ca cag a 


— DFDSS supports enhanced integrated catalog facility catalog recovery. You 
can restore a user catalog without bringing your application program down. 
This allows continuous applications such as IBM DATABASE 2 (DB2) and 
IMS/VS to stay up while a damaged user catalog is replaced. 


~ DFDSS supports VSAM linear data sets. 
— DFDSS supports data set expiration dates beyond the year 1999, 


— DFDSS preserves aliases when VSAM user catalogs are oe or dumped 
and restored. They no longer need to be Be -eTeated 


Faster copying of DASD data. 


The ability to do logical processing at a volume level, thus allowing you to 
restore to an unlike device and to incrementally back up volume pools. The new 
keywords are LOGINDDNAME, LOGINDYNAM, and ALLMULTI. 


Automatic rebuilding of the VTOC free space chain and VTOC index after a 
full-volume COPY or RESTORE to a like device of larger capacity. 


Choice in target volume space allocation, allowing you to allocate by cylinders, 
blocks. or tracks, or to preserve the source space allocation. The new keyword 
is TGTALLOC. 


An improved algorithm to reblock partitioned and sequential data sets. This 
requires MVS/XA DFP Version 2 Release 2 or a later release. 


PAM data sets with NOTE lists are updated. 


DFDSS messages now provide the name of the issuing module, to improve 
serviceability. 


Optional RACF logging to SMF data sets. 


Summary of Changes XV 
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Chapter 1. Introduction to DFDSS ~~ 


Data Facility Data Set Services (DFDSS) is a direct access storage device (DASD) 
data and space management tool. You can use DFDSS to: 


>< @ Copy and. move data sets, between volumes of. like and. unlike device types! . - ts 
ee anes and: restore data sets, entire volumes, or specific éeacks : 

¢ Convert data sets and volumes to and from SMS management 

¢ Compress partitioned data sets 

¢ Release unused space in data sets 

* Reduce or eliminate DASD free-space fragmentation by consolidates free space 


on a volume. 


Stand-Alone DFDSS Restore Program: With the stand-alone DFDSS restore 
program, you can restore: 


© A full volume or ranges of tracks” a Se 

e Your system residence (SYSRES) volume. if your operating system fails to IPL. 
‘Refer to Appendix Cc, “Stand-Alone Restore Program” on page 117 for more* 
information on the stand-alone restore program. 


The Role of DFDSS 


DFDSS can help you perform many of your storage management tasks. The role 
DFDSS plays at your site depends on what other Data Facility products you use. Jn 
particular. the way you use DFDSS depends on whether or not you also use the 
Data Facility Product, Storage Management Subsystem (SMS), and the Data 
Facility Hierarchical Storage Manager (DFHSM). 


To understand the role of DFDSS in an SMS environment, you need a basic 
understanding of SMS. 


Managing User Data with SMS 


SMS can help you efficiently manage space, availability, and performance to meet 
user requirements. 


SMS allows you to match the needs of users’ data (like data set organization, size, 
and format) to the characteristics of storage devices without requiring users to know 
or understand the hardware configuration at your site. With SMS, users can store 
and retrieve data without being aware of space limitations, device characteristics. or 
volume serial numbers. 


Like devices have the same track capacity and number of tracks per cylinder (for example, 3380 Standard and 3380 
Model D or E). Unlike DASD devices have different track capacities, a different number of tracks per cylinder (for 
example, 3350 and 3380). or both. 
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Using SMS, you can define allocation management ¢ criteria forthe different, types of... 


wag erage 


data at your site. The values you: “specify identify’ your users’ requirements for Be 


availability, and performance. ‘ You define these values to SMS as: 


Data Class :- ~~ A named list of data set-allocation‘and space attributes that > 
SMS assigns to a data set when it is created. 


A named list, of Management ; attributes that, SMS. uses. to. , 
> Control DFHSM action for data set retention,’ “migration, | 
backup, and release of allocated but unused space. 





Storage Class A named list of data set storage service attributes that SMS 
uses to identify performance and availability requirements. 


Storage Group A named collection of DASD volumes that have been 
grouped to meet a defined service strategy... .. 


Automatic class selection (ACS) is the SMS mechanism for assigning SMS classes 
and storage groups (otherwise known as constructs). Depending on the DFDSS 
command you are using, SMS invokes some or all of the ACS routines in the 
following order: 


Pt a aab A a a > 2 Ce oc ORT Seltnsiin Ss" ogee ae Ro i 


. Data class ACS routine --- ee ee ee a 
Storage class ACS routine 
Management class ACS routine 
. Storage group ACS routine. .. z 
SMS uses the assigned constructs to automatically place and manage.data and 
storage. For example, you can use a storage class to keep performance- sensitive 
data on high-speed storage devices and management classes to control the movement: 
of less active data to tape. Because SMS controls data placement, you are no longer 
required to perform the time-consuming task of hand-placing this sensitive data. 


For a more complete discussion of SMS and how to use it, see MVS/ESA Storage 
Administration Reference. 


Managing Availability with DFDSS 
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DFDSS availability management consists of backing up data on DASD to tape and 
restoring the backup if the original is lost, damaged, or inadvertently changed. 


The two general forms of backup are: 
Data set backup Protects against the loss of individual data sets. 


Volume backup Protects against the loss of a volume. 


For data set backup, you should consider doing incremental backups to help reduce 
processing time while still meeting your backup requirements. Incremental backup 
means that data sets are backed up only if they have changed since their last backup. 
With this form of backup, data sets are backed up only if they require it. 


Volume backups are used to protect against media failure. You can use volume 
backups in conjunction with incremental data set backups to recover a volume. Asa 
result, you need not do volume dumps as frequently. Incremental data set backups 
should be done on a daily basis and volume backups on a weekly basis. If a volume 
is lost for some reason, you can restore the most recent volume backup and apply 
incremental data set backups to the volume to bring it back to its most current 
status. 
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"Backing Up Volumes and Data Sets ee en jase 


You use the DFDSS DUMP command to back up ryoluines aad data s sets, aril you 
use the RESTORE command to recover them. By doing’a data set DUMP with 
RESET specified and filtering on the data-set-changed flag, you can make ~ 
incremental backups of your data sets with DFDSS. 


. In an SMS environment, DFDSS. saves. the class names for the data sets it. dumps... « 


When you restore the data set to'an SMS volume, DFDSS invokes ACS and passes” 
it the class names saved with the data set. Based upon this and other input from 
DFDSS (for example, class names specified with the STORCLAS or MGMTCLAS 
keywords), ACS assigns SMS constructs to each data set. 


Because DFDSS restore invokes ACS, you can restore the data sets to SMS 
volumes. Conversely, data sets backed up as SMS data sets can be restored as 
non-SMS data sets. 


In addition to providing for routine backup requirements, you can use DFDSS to 
back up application data for disaster recovery and vital records purposes. By using 


_DFDSS logical data set DUMP. and filtering on data set names, you,can back up all .... 


the data sets associated with a particular application for disaster recovery or Vital’: 
records. If you do not want to perform a separate DUMP operation for disaster 
recovery, you can specify more than one OUTDDNAME to create up to 255 
separate backup copies when you do your routine backup. These extra copies can - 
then be used for disaster recovery or vital records purposes. The DUMP command 
can also be used to archive data sets that have not been accessed for long periods of | 
time. 


Using DFHSM for Backup 


DFHSM provides automated incremental backup. interactive recovery, and 
inventory of what it backs up. You can use DFDSS to complement DFHSM 
backup and recovery or, if you do not have DFHSM. to provide for all your backup 
and recovery requirements. 


If DFHSM is being used, you should use DFDSS for volume backup and the 
backup of data sets not supported by DFHSM. If DFHSM 1s not installed, you can 
use DFDSS for all of your volume and data set backup. 


Managing Data Movement with DFDSS 


Moving Data 


DFDSS can help you move data to replace devices. add capacity. and meet 
performance requirements. There are three general tvpes of data movement: data 
set, volume, and tracks movement. 


Using the DFDSS COPY command, you can perform data set, volume, and track 
movement. To perform data set movement, specify COPY with DELETE. This 
causes DFDSS to delete the source data set after it successfully copies the data set. 


Full-volume COPY is useful for moving data between like devices. If you are 
moving volumes to like devices of larger capacity. generally you need to have a 
larger VTOC because the larger device can hold more data sets. DFDSS rebuilds 
indexed VTOCs and recognizes larger VTOCs on target volumes when the VTOCs 
are moved to a like device of larger capacity. However, if you are moving data 
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Moving Data in an SMS Etivironment 


Data set movement is much different in an SMS environment. ACS routines and 
VTOC/Data Set Services determine the target volume in an SMS environment. 


DFDSS moves data sets to different volumes if their storage groups change. 
However, if their storage groups do not change, DFDSS might move the data‘sets to ~ 
a different location on the same volume or to different volumes. 


If a new, empty volume is added to a storage group, data sets moved into that 
storage group are likely to be placed on that volume. This can help you when he 


replace volumes i ee a: storage Stoup- av ee ii a ee us : “e one i ted Fer GS Sag 


pn volumes, the data set is placed on the specified volume(s) if: 
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If a data set’s storage class has the guaranteed space attribute and the user specifies 


, sce s 


° All volumes specified with OUTDDNAME or ‘OUTDYNAM are SMS managed 


| and belong to the, same Storage STOUR. cats ceca 


° The ACS storage group routine assigns ie data set to the storage group nae. 
contains the specified volumes. 


Note: SMS-managed data sets must be cataloged in the standard order of search. 


Converting Data to and from SMS Management 


DFDSS is the primary tool for converting data to and from SMS management. 


There are two ways of converting data to and from SMS management: 


¢ Conversion of data sets with data movement 
¢ Conversion of volumes without data movement. 


The following sections briefly describe these two kinds of conversion. 


Conversion of Data Sets by Data Movement 


4  DFDSS: User’s Guide 


To convert data sets by data movement, use DF DSS COPY or DUMP/RESTORE. 
When moving data sets to SMS-managed volumes from non-SMS-managed volumes, 
DFDSS invokes ACS, which may assign class names to the data sets. Alternatively, 
you can specify the BYPASSACS and STORCLAS keywords on COPY or 
RESTORE to force the data sets to be SMS managed. 


When moving data sets out of SMS management. specify the BYPASSACS and 

NULLSTORCLAS keywords on COPY or RESTORE. This causes DFDSS to 

bypass ACS and drop the data set’s class names. You should also be aware that 
ACS can make data sets non-SMS managed. 
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Conversion of Volumes without Data Movement... societies eae eager Sanat aie «eta! 
To convert volumes to and from SMS ‘aia eonient without data movement, you can 
use the DFDSS CONVERTV command. This command allows you to: aioe 


¢ Prepare a volume for conversion. Using the PREPARE keyword, you can stop 
new allocations and data set extensions to another volume while still allowing 
access to the data on the volume. _ 


wR, wine soph Oeste ae thy a 3 a eed a ie a Pa : creat oes 


ve Convert a volun to SMS iy ngeneat “Usinig the SMS’ Keyword, you can 
convert a volume and all its data sets to SMS management. 


¢ Convert a volume from SMS management. Using the NONSMS keyword, you 
can remove a volume and its data sets from SMS management. 


e Simulate conversion. Using the TEST keyword, you can verify that the volume 
and its data sets are eligible for conversion and see what class names ACS would 
assign to the data sets. 


Managing Space with DFDSS 
" .DFDSS has four functions to help you manage your DASD spacé: SE 


COMPRESS Compresses your partitioned data sets by taking unused space 
and consolidating it at the end of the data set. To make the 
~ unused space available for other data sets, you must use the 
RELEASE command. 


RELEASE Releases the unused space in sequential and partitioned data 
sets for use by other data sets. 


DEFRAG Consolidates the free space on a volume to help prevent 
out-of-space abends on new allocations. 


DUMP/RESTORE Deletes unwanted data sets and combines data set extents. 
(The COPY command can also be used to combine data set 
extents.) 
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| onapier 2. nequirements for supine DFDSS © 


Certain requirements must bei met. in onde to run DEDSS. This chapter describes 
these various requirements: 


eve. 
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Operating Environment 


You can run DFDSS in an MVS system environment. This version of DFDSS runs 
under: 


¢ MVS/370 DFP Version | Release | and its oar sell aca Product 
-(MVS/SP) Version 1 Release 3 | 


¢ MVS/XA DFP Version 2 Release | and its corequisite MVS/SP Version 2 
Release 1.2 


¢ MVS/ESA DFP Version 3 Release | and its corequisite MVS/SP Version 2 
Release 2.3 


week cp SPE ee a ais ie oe e's me EE Ge cD rr en oe ee yo te 
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and any subsequent talents of these spate eehieel programs unless otherwise 
indicated. 


To take full advantage of the new or improved functions of DFDSS Version 2 
Release 5, you must have MVS/ESA DFP version 3 Release: 2 and ee Version 
3 Release 1.0E. — 


Storage Requirements 


In most cases, you can allow DFDSS to determine the amount of storage it uses for 
an operation. Sometimes, however, you might want closer control of the amount of 
storage DFDSS uses. Use the storage estimates in this section as a starting point for 
determining minimum region sizes in which DFDSS can run. Figure | and Figure 2 
on page 8 show the minimum storage requirements, in bytes, to run each DFDSS 
operation. Figure 3 on page 9 shows the minimum storage requirements, in bytes, 
to restore PAM and VSAM data sets to unlike devices. The values include the 
storage required to load the DFDSS program into the region. 


Storage requirements depend on your operating system configuration and your 
device and data set characteristics. The storage requirement estimates shown for 
COPY, DUMP, and RESTORE are for full volume COPY, DUMP, or RESTORE 
only; they might vary for a data set operation. 


If DFDSS determines that the storage requirements are greater than the storage 
available during processing, DFDSS issues error message ADR376E to indicate this. 
The out-of-storage condition might cause an abend 80A during DFDSS 
post-processing. 


If you use buffers above 16 megabytes virtual storage, the buffer size is allocated 
independently of the region size. . 


If you use the PARALLEL command to run two or more DFDSS tasks 
concurrently, the total storage required is the sum of the storage required for all 
functions to be run in parallel. 
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RESTORE (FULL) 








eo ungemaee semmtaper ge 
DFDSS Command. *~ * Storage e Requireme Go ee ae ee 
COMPRESS dsssize & copysize + Q * trksize of largest device) + (a 152K ‘se = 
_ number of additional volumes, up to four) . 
CONVERTV dsssize + (buffersize*5) 
COPY (FULL) dsssize + (trksize * 5). ey 7 
COPYDUMP “os “dsssize + (buffersize * 5) *~ apenas 
DEFRAG dsssize + (trksize * 5) + (16K if VSAM present) 
DUMP (FULL) dsssize + (buffersize * 7) 
OPT(1) 
DUMP (FULL) dsssize + (buffersize * 6) 
OPT(2) . ee Lich heels: aie Saree 
DUMP (FULL) dsssize + (buffersize * 15) 
OPT(3) 
DUMP (FULL) dsssize + (buffersize * (3 * trk/cyl)) 
OPT(4) 
- PRINT | ~ dsssize + (3 * trksize) Oe. 
RELEASE dsssize + trksize 


dsssize & copysize + (buffersize * 6) 


Figure 1. Storage Requirements for DFDSS Operations with I/O Buffers below | 
_ 16- Megabyte Virtual 


DFDSS Command 


COMPRESS 


CONVERTV 
COPY (FULL) 
COPYDUMP 
DEFRAG 


DUMP (FULL) OPT(1) 
DUMP (FULL) OPT(2) 
DUMP (FULL) OPT(3) 
DUMP (FULL) OPT(4) 
PRINT 

RELEASE 

RESTORE (FULL) 


Storage Below 
16 Mb Virtual 


Storage Above 
16 Mb Virtual 


dsssize & copysize = 2 * trksize of largest device 
1152K * number of 


additional volumes, up to 


four 

dsssize buffersize * 5 
dsssize trksize * $ 
dsssize buffersize * 5 
dsssize + 16K if VSAM trksize * 5 
present 

dsssize buffersize * 7 
dsssize buffersize * 6 
dsssize buffersize * 15 
dsssize buffersize * (3 * trk/cyl) 
dsssize 3 * trksize 
dsssize trksize 

dsssize buffersize * 6 


Figure 2. Minimum Storage Requirements for DFDSS Operations with I/O Buffers above 
16-Megabyte Virtual 
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PAM Data Sets dsssize + (((trksize + 64) * 5) + 8K) 
VSAM Data Sets dsssize + (((trksize + 64) * 5) + (2 * maximum record size) Pos, 


(3 * buffspace)) 
Figure 2: Minimum Sioreee: aaa ie a Restore to. an Pause Device ti 
Legend - Oe 
K 1024 bytes 
| dsssize DFDSS load module size, 1240K 
| copysize IEBCOPY load module size 
buffersize The maximum of trksize and default maximum block size (32K) — 
buffspace Buffer space specified in DEFINE command when data set was allocated 
trksize The size, in bytes, of a track on your DASD volume 


trks/cyl | The number of tracks per cylinder, on your DASD volume, 


, DASD Requirements 
You can use DFDSS with the following IBM DASD: 
2305 Fixed Head Storage Model 2~ 
3330 Disk Storage Models | and 11 
3340 Direct Access Storage Facility 
3344 Direct Access Storage 


3350 Direct Access Storage (in native mode and in IBM 3330 Models | and 11 
compatibility mode) 


3375 Direct Access Storage 
3380 Direct Access Storage (all models) 
3330 virtual volumes residing in an IBM 3850 Mass Storage System. 


In addition, you can use DFDSS with all magnetic tape devices, system consoles, 
printers, and card readers supported by Data Facility Product. 


Stand-Alone DFDSS Restore Program 
| Refer to Appendix C, “Stand-Alone Restore Program” on page 117 for a list of 
devices you can use with the stand-alone DFDSS restore program. 
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~~ Volume Formats ~ ae. 
“You can use e DFDSS with the following DASD volume formats: 
e Volumes with indexed’ Vv TOCs 
¢ Volumes with nonindexed VTOCs 
‘ ac. oe OSV S Tainivolumes | ina VM. environment. see : os sin fe S rete a aan MB 


All DASD volumes used . DFDSS must be initialized by Device Support Facilities 
(ICKDSF). 


Data Set Organizations 


DFDSS can copy, dump, and restoré data sets of the following organization foes 


SAM (sequential access method) 
| PAM (partitioned access method) 
| PDS (partitioned data set) 
tL. e ae . _. .... PDSE (partitioned data set extended) 0-02. -- 6. ee Be re 
oO ' -- BDAM (basic direct access method) | es 
ISAM (indexed sequential access method) 
VSAM? (virtual storage access method), including: 
ESDS (entry-sequenced data set) 
RRDS (relative record data set) 
KSDS (key-sequenced data set): --: 
KSDS with key ranges 
LDS (linear data set) 
DATABASE 2 (DB2) 
DATABASE 2 (DB2) data sets, supported 
EXCP (execute channel program) 
Unmovable data set types (PSU, POU, DAU, ABSTR, ISU, BDAM with 
OPTCD =A). 


2 VSAM data sets that are cataloged in an integrated catalog facility catalog 
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Chapter 3. Logical/Physical ene and Data Set Filtering 


Before you begin using ‘DFDSS, you i eheuld fedeniaiid the difference neteen 
logical and physical processing and how to use data set filtering to select data sets 
oe for processing. , The following sections describe these:two aspects of DFDSS, __ 


ar 


Logical and Physical Processing 


DFDSS can perform two kinds of processing when executing COPY, DUMP, and 
RESTORE commands: 


¢ Logical processing operates against data sets independently of physical device : 
format. 


¢ Physical processing moves data at the track-image level and operates against 
volumes, tracks, and data sets. 


Each type of processing offers different.capabilities and advantages. © << . 


During a RESTORE, the data is processed the same way it was dumped because 
physical and logical dump tapes have different formats. If a data set is dumped | 
logically, it is restored logically. If it is dumped physically, it is restored physically. 


Logical Processing 
A logical COPY, DUMP, or RESTORE treats each data set and its associated 
information as a logical entity, and processes an entire data set before beginning the 
next one. Each data set is moved as a set of data records, allowing data movement 
between devices with different track and cylinder configurations. 


DFDSS performs logical processing if: 


¢ You specify the DATASET keyword with COPY. A data set COPY is always a 
logical operation, regardless of how or whether you specify input volumes. 


¢ You specify the DATASET keyword with DUMP, and either no input volume is 
specified, or LOGINDDNAME or LOGINDYNAM is used to specify an input 
volume(s). 


¢ The RESTORE command is performed and the input tape was created by a 
logical DUMP. 


Both catalogs and VTOCs are used to select data sets for logical processing. The 
catalogs are used to select data sets for COPY and DUMP if you do not specify 
input volumes. If you specify input volumes for COPY, the VTOCs are used to 
select data sets. If you specify input volumes for DUMP with LOGINDDNAME or 
LOGINDYNAM, the VTOCs are used for selecting data sets. 


Note: To copy or dump entire multivolume data sets, you need not specify all the 
volumes in the LOGINDDNAME or LOGINDYNAM volume list when you also 
specify the ALLMULTI keyword. 
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“When to: Mee Logical Processhtge eee eee ee 
a, . -You should use logical processing when: - a a es 


’ 


- Data that may. need to. be. restored to an a unlike, device i is dumped. :. ee ee 


. Unmovyable. data sets or, data. sets with absolute. track alles sot are Moy, ved to ) 


Data is copied to an unlike device type. 


Logical processing is the only way to move data between unlike device types. 


Data must be restated the same way it was danced: This i is Sone 
important to bear in mind when making backups that you plan to retain for a 
long period of time (such as vital records backups). If a backup is retained for a 
long period of time, it is possible that the device type it originally resided on will 
no longer be in use at your site when you want to restore it. This means you 
will have to restore it to an unlike device, vod can be done only if a backup 
was made logically. a 


Aliases of VSAM user catalogs are to be preserved during copy and restore. 


Aliases are not preserved for physical processing. 


sh ae : 


different locations. 


Multivolume data sets are processed. 


..VSAM and multivolume data sets.are to be cataloged in a different catalog... 


Data sets are to be deities from the source volume after a sonaseate dump or 


z copy. fasts ; ae 465 ae Ere te = earns Re ete 


Both non-VSAM and VSAM data sets are to be renamed after a successful copy 
or restore. 


You want to control the percentage of space allocated on each of the output 
volumes for copy and restore. 


You want to copy and convert a PDS to a PDSE or vice versa. 


You want to copy or restore a data set with an undefined DSORG to an unlike 
device. 


Physical Processing 
Physical processing moves data based on physical track images. Because data 
movement is carried out at the track level, only target devices with track sizes equal 
to those of the source device are supported. Physical processing operates on 
volumes, ranges of tracks, or data sets. For data sets, it relies only on volume 
information (in the VTOC and VVDS) for data set selection, and processes only that 
part of a data set residing on the specified input volumes. 


DFDSS performs physical processing if: 


e 
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You specify the FULL or TRACKS keyword with COPY or DUMP. This 
results in a physical volume or physical tracks operation. 


You specify the DATASET keyword on the DUMP command and input 
volumes with the INDDNAME or INDYNAM parameter. This produces a 
physical data set dump. 


The RESTORE command is executed and the input volume was created by a 
physical DUMP. 
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You should use aiiaicdl processing when: 


Backing up system volumes that you might want to restore with stand-alone 
DFDSS restore. . 


Stand-alone BER restore euppoxt meen piace! cuap tapes. 


alot av an soythesty 
ee my : 


Performance is an issue. ee aa ea 


Generally, the fastest way—measured by elapsed time—to copy or dump an entire 
volume is with a physical full volume command. This is primarily because 
minimal catalog searching is necessary for physical processing. 


Substituting one physical volume for another or recovering an entire volume. 


With a COPY or RESTORE-—full volume or track—the volume serial number of 
the input DASD volume can be copied to the output DASD volume. 


Dealing with I/O errors. 
Physical processing provides the cap aPUly to ie DUMP, and AEP HORE a 


_. Specific track or range of tracks. 


Choosing Data Sets for Processing—Filtering | 


You can select data sets for DFDSS processing by filtering ¢ on pected’ criteria. 
DFODSS can filter on fully- or partially-qualified data set names. (by using the | 

- INCLUDE or EXCLUDE keyword) and on various data set characteristics (by 
using the BY keyword). 


You can filter data sets with any of the following commands: 


* Logical DUMP 


Logical RESTORE 

Physical data set DUMP 
Physical data set RESTORE 
Data set COPY 
COMPRESS 

DEFRAG 

RELEASE. 


At least one of the INCLUDE, EXCLUDE, or BY parameters must be specified 
with the above commands. 


The following sections briefly describe what you can filter on and how you might use 
the available criteria. 
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ere met Data Set Names * son i cy Santi qehvenin ORM 
_ Using INCLUDE or EXCLUDE; you can filter on fully- or. saially auskiels data 
set names. A fully-qualified data set name is one in which all qualifiers are» 
completely spelled out.- For example: _ . 


BRE ED NCLUDE(SYST.UTIL3: LOAD) ) Po FF Rete oe 2 





A partially-qualified data set name is one in which the qualifiers are not completely 
spelled out. Using asterisks (*) and percent signs (%), you can select data sets 
without specifying their fully- aoe names. 


The single astenele (*)1 is used in live of one austen Fc or exuaicle 


(INCLUDE (ABC.*. LOAD) ) 





This partially-qualified name matches ABC.DEF.LOAD and ABC.XYZ.LOAD. 
The single * is also used to indicate to DFDSS that only part of a qualifier has been 
specified. For example, if you want to filter using only the first three characters of 
the first qualifier of a name, specify it as follows: 


tek 


(INCLUDE (SYS*.**)) 





This partially-qualified name matches data sets whose first qualifier was SYS1 and 
SYSI1A. The other qualifiers in the data set name are ignored. 


When used with other qualifiers, the double asterisk (**) indicates that one or more 
leading, trailing, or middle qualifiers do not exist or they do not play a role in the 
selection process. For example: 


(INCLUDE (**.LOAD) ) 





This partially-qualified name selects any data set with LOAD as its last qualifier 
(such as data sets named LOAD, ABC.LOAD, and ABC.DEF.LOAD). 


The percent sign (%) is used as an ignore character. One or more %s can be 
specified in any qualifier. Each specification represents one character in the name 
being filtered and any character in that position in the name is ignored. For 
example: 


(INCLUDE (SYS1.A%%B) ) 





This partially-qualified name matches SYS!1.AZZB and SYS1.AXYB, but not 
SYS1.AXXXB. 
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“Fitering So Data Set Characteristics . =~. :sitssarsas cages siesirs oo mnahtegiey tt ot 
In addition to filtering on data set names, you can also filter on the following data 
set characteristics: 


Allocation type (cylinder, track, block, absolute track, or movable) 

Creation date (absolute or relative) 

__ Expiration date (absolute or relative) ee em ee ener eee ee 
~\. Last-referenced date? (absolute or- eee, SMe code ad nel ener ares 
Data set organization (SAM, PAM, PDS, PDSE. BDAM, EXCP, ISAM, or 
VSAM) 

Data set size (number of allocated or used tracks) 

Number of extents 

Whether the data set is single- or multivolume 

Whether the data-set-changed flag is on or off? . 

SMS class names (data, management, and storage class) 

Whether a data set is cataloged or not (using the standard catalog search order). 


You can use any of the following operators with the BY keyword: 


EQor= ~~ -Equalto .. gl age ee Ee kaa tts 2 inom 
LT or < | Less than. 

LE or <= Less than or equal to _ 

GTor> | _ Greater than — : 

GE or >= - Greater than or equal to 

NE or == Not equal to. 


When you specify multiple arguments for an NE operation, DFDSS selects only 
those data sets not matching any of the arguments. When you specify multiple 

rguments for an EQ operation, DFDSS selects those data sets matching any of the 
arguments. 


3 The data-set-changed flag (DSCHA) and the last-referenced date (REFDT) are supported only on systems that have 
data-set-changed flag support installed. For VSAM data sets, DSCHA and REFDT are maintained by Data 
Facility Hierarchical Storage Manager (DFHSM). Therefore, if you do not have DFHSM on your system, module 
IDATMSTP (in load module IDA0192A) should be modified to pass a return code of 4 to its caller. 


Chapter 3. Logical/Physical Processing and Data Set Filtering 15 


Re eerie G eta by 7 wn sony Pee re ee gba ses recy taba r 
CODES Say oe ee ode ie MMs ME SES a De Sa Meee § Re oe a EERE RTD 








ha i tectine a oA abies tee Rene ak Bt pepe 
Ramis arti th My aapaen. irae ie) sete ates Sica EE Re eer Beers tues PM ere zak, td hig ee : ee apstk 
sae Se? Rae vers SE ee TE ae da kad ae te FOR ak Reet ae pa cre ae Sass ST Ses ‘ ss 


..Some Examples of Filtering by Data Set Characteristics.:1- #15. 1t6vos- goiter Gasehnegmmen Aaa 
_ Ifyou use the following specification of the BY keyword, DFDSS selects all data faite 
~ sets allocated in cylinders: 


wg 





4 ee ye Loge RA, - = a cr . roo Pee : eet ae iu 22 . <* ie “6 os: tats: * =< ‘e ea ade Son Ne Pa seis oH te a, 2 z os ne a ee ay 


You can specify more than one criterion with the BY keyword. The following 
example selects all data sets allocated in cylinders and whose management class is 
MCNAMEI: | 


BY(( ALLOC,EQ,CYL ) ( MGMTCLAS,EQ,MCNAME1 )) 





You can specify multiple arguments for any of the filtering criteria. The eee. 


| BY( DATACLAS,EQ, (DCNAME1,DCNAME2) ) _ 





Some Uses of Filtering , 
To make good use of filtering by data set names, you should have meaningful 
naming conventions. Your naming conventions should allow you to identify large 
groups of data sets that can be treated similarly. If you have such conventions, you 
can use DFDSS data set name filtering to select large groups of data sets against 
which you can run DFDSS functions. 


For more information on setting up data set naming conventions, see SML: 
Managing Data Sets. 


Suppose you are a storage administrator and every day you want to back up all 
payroll data sets that have changed since they were last backed up. If the data sets 
you need to back up have some identifying qualifier(s), perhaps 
PAYROLL.FEDTAX, you can select them by coding: 


Fg ae Pe Gp ee PO Sg Oe ns ga RAN SAWS wee A Oo ae ee a eG gs ee a el 


_ [/NRPAY JOB Accounting Information,MORGAN 

| //STEP1 EXEC PGM=ADRDSSU,REGION=4000K 

//SYSPRINT DD SYSOUT=* 

i / /DROUT DD DSN=PAYROLL.DAY1,DISP=(NEW,CATLG) ,UNIT=3480 

//SYSIN DO: i.e 

DUMP DATASET(INCLUDE(PAYROLL.FEDTAX.**) - 

BY((DSCHA,EQ,YES) (MGMTCLAS,EQ,DAILY))) - 

| QUTDD(DROUT) 


Le 
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sets. You can use BY Criteria to: 


e Filter on the data- set-changed- flag to back up only those data sets that have not 
been backed up since they were last updated. 


¢ Filter to select uncataloged data sets for deletion as a means of enforcing 
cataloging. . 


eR Le Pat Bey LUFF Pee in ‘ : * . a oe ee ” rei meats gah 


° Filter to selece ‘data sets whose’ ton dae eee for deletion.” 


¢ Filter on the last referenced date and archive or delete data sets that have gone 
unreferenced for a long period of time (for example, 18 months). 


e Filter on data set size to ensure that when you use COMPRESS and RELEASE 
you only compress and release space in ote sets where the savings aay, Pe 
significant. © = 


e Filter on management class to perform space management. 
It is possible to pass DFDSS filtering criteria in a data set. If you do this, the data 
set should have the following Sheree Ets: 


‘RECFM = F or FB 
LRECL=80 
BLKSIZE = 80 for F or multiple of 80 for FB. 
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Chapter 4." Changing Command epecuceuone for DFDSS~ = 


Version 2 Release 5 


Some new keywords have been added for DFDSS Version 2 Release 5. The 
ae -~ following sections briefly explain what. these new keywords are and how they affect 2 2 
a: ~ '  _DFDSS processing. ; 


Note: Refer to Appendix B, “Changing Command Specifications for DFDSS 
Version 2 Release 4” on page 113 for new keywords for that release. 


Converting to and from a PDSE . 


You can use the CONVERT keyword in conjunction with the PDSE are or 

the PDS subkeyword when you perform a DFDSS COPY operation. If you use the 

PDSE subkeyword, the resulting target data set will be converted from the PDS 

format to the PDSE format. If you use the PDS subkeyword, the resulting target 

data set will be converted from the PDSE format to the PDS format... MVS/DFP V3° 0 => 
R2 and MVS/SP V3 R1.0E are required for this operation. 


Restrictions for COPY, DUMP, andRESTORE © 2 2 
A PDSE cannot be copied, dumped, or restored on a system using ea prior to 
_ DFDSS Version 2 Release.5 nor can they be copied, dumped, or restored on a. 
” system using releases prior to MVS/DFP V3 R2 and MVS/SP V3 R1.0E 


Processing SYS1 Data Sets 


You can use the new PROCESS keyword in conjunction with the SYS1 subkeyword 
to: 


¢ Copy SYS1 data sets to preallocated targets 
¢ Move SYS! data sets 
* Allow DELETE when logically or physically dumping SYS1 data sets 


¢ Release unused space in SYS1 data sets. 


Processing Undefined DSORG Data Sets 


You can use the new PROCESS keyword in conjunction with the 
UNDEFINEDSORG subkeyword to: 


¢ Copy a data set with an undefined DSORG to an unlike device of larger track 
capacity 


¢ Logically restore a data set with an undefined DSORG to an unlike device of 
larger track capacity. 
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If the TGTALLOC keyword is omitted when you use the COPY or RESTORE 
commands, the target allocation default has changed trom tracks to source. 
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Specifying Both the OPTIMIZE and COMPRESS Keywords! jor 
Dumps 


You no longer must choose between performance (by specifying OPTIMIZE) or 
saving space (by specifying COMPRESS). The two ees can be Liens 
together; they are no longer mutually exclusive. 2 


| Selecting Arguments for Filtering by Data Set Characteristics 


| PDS or PDSE are new mearamene that you can use to p duaaly the selection 
i a ee :. characteristics of a data set. i Nea a hg 


| Specifying the Status of the Target Generation Data Set 


| With the TGTGDS keyword, you can perform a data set COPY or tor to 
| . specify the final status of a SMS-managed GDG data set.. 
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Chapter 5. Invoking DFDSS| 


You can invoke DFDSS in any one of three ways: 


e¢ With the Interactive plore ee F dove niin 
¢ With JCL:: en ee 
¢ With the Application interface” 


General programming interfaces are contained in this chapter. 


Invoking DFDSS with ISMF 


You can use the menu-driven panels of ISMF, a component of the MVS/XA Data 
Facility Product, to build job streams for many DFDSS space management and 
backup functions of DFDSS. ISMF supports the DFDSS commands COMPRESS, 
CONVERTV, COPY, DEFRAG, DUMP, RELEASE, and RESTORE. 


The information you supply on ISMF panels is used to build and submit job streams 
like those you generate using JCL and DFDSS commands. Using ISMF panels, you 
no longer have to rmember DFDSS keywords and syntax. You merely fill in the 
values you want on the panels and ISMF generates the job stream. You can then 
either submit the sePis or save the job stream for later use. 


‘Using ISMF panels, you can 1 construct a ‘list oe dats ets or volumes. The list 
provides you with a variety of information about each volume or data set (for 
example, allocated space and percent of unused space). The list-building process is 
similar to filtering in DFDSS—you supply the selection criteria to ISMF, and ISMF 
builds a list of data sets or volumes that fits your criteria. Because the list provides 
so much different information in one place, you can use it to analyze and manage 
your data and storage more efficiently. 


How to Invoke ISMF 


You invoke ISMF by logging on to TSO. If ISMF is installed as an option on the 
ISPF Master Application Menu or as an option on the ISPF/PDF Primary Option 
Menu, specify the selection option that corresponds to ISMF. To select ISMF in the 
ISPF Master Application Menu (see Figure 4 on page 22), enter I following the 
arrow on the command line. 
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. ISPF MASTER APPLICATION MENU --- a a a as 
* SELECT APPLICATION ===> I 
YSERID.. := IBMUSER 


1 SPF “SPF PROGRAM DEVELOPMENT FACILITY TIME - 07:30 
oo Sex - ante TERMINAL - 3279 
x so a KEYS - 12 : 
: ay sores * ae Ts rs mt @ 08s i edad Be eee a . ae Fa ~ = 
a E eee aces: -L INTERACTIVE STORAGE MANAGEMENT FACILITY i ia 


> wee 


- SPECIFY TERMINATION PARAMETERS AND LIST/LOG DEFAULTS 
~ TERMINATE USING LIST/LOG DEFAULTS 


Pe cad 


PRESS THE END KEY TO TERMINATE = 





Figure 4. Starting an ISMF Sescion from the ISPF Master Application Menu 


7 Or if you want to aves ISMF directly from TSO, use this cenihans 
ISPSTART PGM(DGTFMDO1) NEWAPPL(DGT) . . 


- In either case, the ISMF Primary Option Menu appears (Figure 5), and you can 
begin an ISMF session. 


ISMF PRIMARY OPTION MENU 
ENTER SELECTION OR COMMAND ===> 1 





| SELECT ONE OF THE FOLLOWING: 


QO ISMF PROFILE - Change ISMF user profile 

1 DATA SET - Perform Functions Against Data Sets 

2 VOLUME - Perform Functions Against Volumes 

3 MANAGEMENT CLASS - Specify Data Set Backup and Migration Criteria 
4 DATA CLASS - Specify Data Set Allocation Parameters 

5 STORAGE CLASS - Specify Data Set Performance and Availability 
X EXIT - Terminate ISMF 


USE HELP COMMAND FOR HELP; USE END COMMAND TO EXIT. 





Figure 5. ISMF Primary Option Menu 
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ISMF Data Set Application Peas J 
You can use the data set apelication oe ISMF | to perform DFDSS functions against 
one or more data sets on a list you create. See ISMF User’s Guide for more 
‘information on generating data set and volume lists. 
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Banat a wees of Data Sets 
Complete the Data Set Selection Entry. Panel with the values shown to the right of | 
the arrows in Figure 6. Entering ** in the “Data Set Name” field selects all data ” 
sets that have your user ID as their high-level qualifier. 


When each panel first appears, it is primed with the last-used values. If you want 
the default for any field instead, enter blanks over the last-used value. 


DATA SET SELECTION ENTRY PANEL Page 1 of 4 


0 ===> 
FOR A DATA SET LIST, SELECT SOURCE OF GENERATED LIST ===> 2 (1 OR 2) 


1 GENERATE FROM.A SAVED LIST Bates, se 
LIST NAME ===> 2%, Ata hiv mensiSete 


2 GENERATE A NEW LIST FROM CRITERIA BELOW 
DATA SET NAME ===> ** 


~ SPECIFY SOURCE OF THE NEW LIST ===> 1 (1 - VTOC, 2 - Catalog) 


1 GENERATE LIST FROM VTOC 
VOLUME SERIAL NUMBER ===> 338002 (fully or partially specified) 


2 GENERATE LIST FROM CATALOG 
CATALOG NAME ===> 
CATALOG PASSWORD (if password protected) 
VOLUME SERIAL NUMBER (fully or partially specified) 
ACQUIRE DATA FROM VOLUME ===> Y (Y or N) 
ACQUIRE DATA IF DFHSM MIGRATED ===> N (Y or N) 


USE ENTER TO PERFORM SELECTION; USE DOWN COMMAND TO VIEW NEXT SELECTION PANEL; 
USE HELP COMMAND FOR HELP; USE END COMMAND TO EXIT. 





Figure 6. Complete Page | of the Data Set Selection Entry Panel 


Press Enter to generate the Data Set List. A list that conforms to your selection 
criteria appears, as shown in Figure 7 on page 24. 
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DATA SET LIST e 
COMMAND ===> copy = 27 SCROLL ===> HALF 
: ans Le: Sar ee ees . .,, Entries 1-5 of 5 
ENTER LINE OPERATORS BELOW: “°° ¢ °° > “" """ Data Columns 3-7 of 31 


LINE ALLOC ALLOC % NOT NUM ALLOC 
; OPERATOR _, DATASET NAME _ EXT, UNIT i 
bel Me bya 95g dn risa ace : pote ag) panes xe : 
hak ee ST BMUSERTENTL. CNTL. “TRK 
IBMUSER. ISMF. COPY.D87035. BLK 
7111457 
IBMUSER. ISMF. COPY.087035. 
7120522 
IBMUSER. ISPPROF 141 
IBMUSER. TONYS. STUFF 141 
BOTTOM OF DATA 








USE HELP COMMAND FOR HELP; USE END COMMAND TO EXIT. ....-»- 


Figure 7. The Resulting Data Set List 


. .-The data sets selected have your user ID as the high-level qualifier because you — 
entered ** in the “Data Set Name” field of the Data Set Selection Entry Panel. 


Copying the Data Sets to a 3380 
Next, you can copy all of the listed data sets to a 3380. Enter COPY on the 
command line of the Data Set List Panel that you generated as shown in Figure 7. 
ISMF then displays the first page of the COPY Command Entry Panel, Figure 8. 
(Alternatively, to copy an individual data set, enter COPY in the “Line Operator” 
column next to that data set’s name.) 


COPY COMMAND ENTRY PANEL Page 1 of 13 
COMMAND 


SPECIFY ONE OR MORE FOR THE 5 DATA SETS: 
TARGET VOLUMES 


PERCENT UTILIZATION 
at 


# Rm 
t ou 
Vv 


uoeu o& 
Vv 
1O 
ve} 


Vv 


SELECT WHERE TO CATALOG TARGET DATA SETS 
1 DO NOT CATALOG 2 SAME CATALOG 4 NEW CATALOG 
SPECIFY NEW CATALOG NAME ===> 


OPTIONALLY SPECIFY ONE OR MORE: 
REPLACE DUPLICATES 
REBLOCK TARGET DATA SETS 
RACF MODEL DATA SET NAME 
RACF MODEL VOLUME SERIAL 


v 


v 


nok ou 

hot Hott 

oof be oa 
Vv 


v 


VIEW OR CHANGE ADDITIONAL COPY OPTIONS ===> Y  (Y or N) 


USE ENTER TO CONTINUE; 
USE HELP COMMAND FOR HELP; USE END COMMAND TO EXIT. 





Figure 8. Completing Page | of the COPY Command Entry Panel 
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- Complete the first page of the COPY’‘Command Entry Panel ‘as shown in Figure 8. 
Press Enter to display page 2 of the COPY Command Entry Panel, Figure 9. 


OE ee eee en pg sn akan ey 
COPY COMMAND ENTRY PANEL Page 2 of 13 





‘OPTIONALLY SPECIFY ONE"OR MORE FOR THE '5°DATA’SETS: “20 


IF SQURCE DATA SETS ARE PASSWORD PROTECTED, SPECIFY: 
PASSWORD DSN ===> 


SELECT DISPOSITION OF SOURCE DATA SETS ===> 1 
1 KEEP 
2 UNCATALOG 
3 UNCATALOG AND SCRATCH ALL 
4 UNCATALOG AND SCRATCH IF EXPIRED 
5 UNCATALOG ALL, SCRATCH IF EXPIRED 


USE ENTER TO CONTINUE; USE DOWN TO VIEW MORE COPY COMMAND oni 
USE HELP COMMAND FOR HELP; USE END COMMAND TO EXIT.- ~~ 





Figure 9. Completing Page 2 of the COPY Command Entry Panel 


Scroll forward if you want to view more entry panels, or press Enter if the field 
defaults are acceptable. If Enter is pressed, the COPY Job Submission Entry Panel. 
Figure 10, appears. 










COPY JOB SUBMISSION ENTRY PANEL 
COMMAND ===> 












| SELECT ONE OF THE FOLLOWING ===> 
1 SUBMIT JOB FOR BACKGROUND PROCESSING 
2 SAVE GENERATED JOB IN A DATA SET 


| IF OPTION "2" IS SELECTED, SPECIFY: 
| DATA SET NAME ===> 
REPLACE CONTENTS ===> 





| N (Y or N) 
JOB STATEMENT INFORMATION: (verify before proceeding) 
> //TBMUSERF JOB (account), 'name' 


==> //* 
==> //* 
se> //* 
asp //* 
==> //* 
n> //* 


nob & WH hou 


| VIEW OR CHANGE EXECUTE STATEMENTS FROM PROFILE ===> Y (Y or N) 








USE ENTER TO CONTINUE; 
USE HELP COMMAND FOR HELP; USE END COMMAND TO EXIT. 






Figure 10. Verifying the COPY Job Statement Information 


Note: If, instead, you want to save the generated JCL and DFDSS command for 
later use, you can do so. 
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.: Verify the JOB statement on this:panel. Then préss Enter to view the DFDSS ” 
Execute Statement Entry Panel. ; 


DFDSS EXECUTE STATEMENT ENTRY PANEL 
COMMAND ===> 





mien A is 
ee | al 

it Lie 
se=> //STEPL 
zs=> //SYSPRINT DD 


EXEC PGM=ADRDSSU, REGION=nnnnk 
SYSOUT=* 


USE ENTER TO CONTINUE; 
USE HELP COMMAND FOR HELP; USE END COMMAND TO EXIT. 


Figure. 11. The pee acl etatement Entry Panel 


Press Enter to stbatit the sieb: ISMF then displays the Data Set List, Figure 12. 
The asterisks before each COPY command in the Line Operator column indicate 
that the job was successfully submitted. 









COPY JOB CREATED 
SCROLL ===> HALF 
Entries 1-5 of 5 

Data Columns 3-7 of 31 


DATA SET LIST 
COMMAND === 










ENTER LINE OPERATORS BELOW: 









LINE ALLOC ALLOC % NOT NUM ALLOC 
OPERATOR DATA SET NAME SPACE USED USED EXT UNIT 
n--(I)--=-  -na----==--- (2) nonwenanwnan n= (3)-- ~=(4)-- -(5)- (6) -(7)- 
*COPY IBMUSER.CNTL.CNTL 2436 2436 0 1 TRK 
*COPY IBMUSER. ISMF.COPY.D87035. 19 19 Q 1 BLK 

7111457 
*COPY IBMUSER. ISMF.COPY.D87035. 19 19 0 1 BLK 
T120522 
*COPY IBMUSER. ISPPROF 141 141 0 1 = TRK 
*COPY IBMUSER. TONYS. STUFF 141 a7 66 1 = TRK 






eciscenete, Bester, tee edema BOTTOM: OF DATA. 2Ssc-2oceen” G.o-22 






USE HELP COMMAND FOR HELP; USE END COMMAND TO EXIT. 


Figure 12. The List with Successful Submission of the COPY Command 


26 DFDSS: User’s Guide 








er eo ay a; sR “se DF Tess se tye a he Seat ee ses Lene Mets deh aes Sep beet: in os Foew sical ye acy lh igen hen 
Fens rege mals oe : . tae ha Oe ans 
Te pea eh ee ae Ly oa Ree gee Wd Bo RAR oe ba AOE te Te ET OF eb Gn eran, ROE et 


ISMF Volume Apcicatica 


EERE oe neh are ot te ta eet 
Pape tions a vita pow ah fe NERA, “~, “Cas poe ae 2 ane a 


a gd: 
g 


RS ces oa CE 9S BSE OCT, ORL ss a 


is 


Building a Volume List 
Building a volume list is similar to building a data set list. You simply complete the 
Volume Selection Entry Panel as shown in Figure 13 by specifying your volume 
serial number. Verify that pages 2 and 3 of the Volume Selection Entry Panel are 
blank. If they are not blank, you receive the short: informational message: - OTHER : 
“VALUES PRESENT. — 


VOLUME SELECTION ENTRY PANEL Page 1 of 3 
| COMMAND ===> 


| SELECT SOURCE TO GENERATE VOLUME LIST ===> 2 (1 - saved list, 2 - new list) 


| 1 GENERATE FROM A SAVED LIST 
| LIST NAME ===> 


| 2 GENERATE A NEW LIST FROM CRITERIA BELOW 
| SPECIFY SOURCE OF THE NEW LIST ===> 1 (1 - Physical, 2 - SMS) 


be PS i OPTIONALLY SPECIFY ONE OR MORE) 0 0 se sg 

| TYPE OF VOLUME LIST >1 (1-Online, 2-Not Online, 3-Either) 
VOLUME SERIAL NUMBER LIB* (fully or partially specified) 

DEVICE TYPE (fully or partially specified) 

| DEVICE NUMBER (fully specified) . 

| ; “TO DEVICE NUMBER © (for range of devices) wet 

ACQUIRE PHYSICAL DATA (Y or N) 

ACQUIRE SPACE DATA ; (Y or N) 

STORAGE GROUP NAME (fully or partially specified) 

CDS NAME ===> 

| (fully specified or ‘ACTIVE') 


= 


Vv 


io ou ow iw 
tow oo 
hou th of 


Vv 


“a 
oo 
“ow 
vv 





USE ENTER TO PERFORM SELECTION; USE DOWN COMMAND TO View NEXT SELECTION PANEL; 
USE HELP COMMAND FOR HELP; USE END COMMAND TO EXIT. 





| Figure 13. Complete Page 1 of the Volume Selection Entry Panel 


Press Enter to generate the volume list, as shown in Figure 14 on page 28. 
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_.MOLUME LIST 


COMMAND ===> ° SCROLL ===> HALF 
ee ae Geis _ eo Oke ee we) ae i Sous g ENELIOS Dab OF 1 
tae Naa —— ENTER LINE OPERATORS BELOW:  o~= ~~ © ~ Data Columns 3-8 of 39 
LINE VOLUME FREE % ALLOC FRAG LARGEST FREE | ! 
ae: CGE big ade ooce sca J elengrORERATOR..,, SERIAL, SPACE 3 .FREE SPACE... INDEX, EXTENT. EXTENTS 0... g| shee 8 os 
a ARR ed Peta 7) PO) RCRA) Be 7) PALS (5 So) | ke) a 


LIBTST 115845 19 506006 461 25296 58 
LIBQ01 100154 521697 300 40145 
BOTTOM OF DATA 


Saar ae, : bee 


“USE HELP COMMAND FOR HELPS USE END ‘COMMAND 10 ‘EXIT. 





Fi igure 14. The Volume List — 


> ir 


Note: DF DSS list commands bas not work ie volume lists. 


Dumping a Volume 

Enter the DUMP line operator for the volume in the list, as shown in Figure 14, to 
dump the volume. ISMF displays the DUMP Entry Panel as shown in Figure 15. 
DFDSS commands can be issued against one volume at a time as a line operator. 





DUMP ENTRY PANEL Page 1 OF 8 



















COMMAND ===> 


SPECIFY ONE OR MORE FOR VOLUME: LIBTST 


IF OUTPUT DATA SET IS OR NOT CATALOGED, SPECIFY: 
VOLUME COUNT 
OUTPUT VOLUMES 
QUTPUT VOLUMES 
OUTPUT VOLUMES 

UNIT 


v 


v 
Vv 


oot Wu ow at 
oH ot RB fl 
uo ow nw ou u 
v 
u ou on 
ue on 
uoew oR 
Vv 
nou ow 
# Ww ow 
uo ow on 
v 
tou oa 
aoe 4H 
“oi 6 
v 


v 


NUMBER OF COPIES ===> 1 (1 to 5 copies) 
QUTPUT MEDIA TYPE ===> TAPE (TAPE or DASD) 
sss> 2 


| 
OUTPUT DSN ===> tape.dump 
i 
| 
| (1 LOGICAL, 2 PHYSICAL) 


TYPE OF DUMP 


IF SOURCE DATA SETS ARE PASSWORD PROTECTED, SPECIFY: 
PASSWORD DSN) ===> 


VIEW OR CHANGE CURRENT ALLOCATION VALUES 
VIEW OR CHANGE ADDITIONAL DUMP OPTIONS 


=> Y (Y or N) 
=> Y (Y or N) 






USE ENTER TO CONTINUE; USE HELP COMMAND FOR HELP; USE END COMMAND TO EXIT. 


Figure 15. Page 1 of the DUMP Entry Panel 


Complete the DUMP Entry Panel as shown in Figure 15 and press Enter to display 
page 2. 
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: DUMP ENTRY PANEL Page 2 OF 8 
COMMAND ===> 


SPECIFY ONE OR MORE TAPE ALLOCATION VALUES FOR VOLUME: LIBTST 


LABEL TYPE s==> SL (SL, SUL, NL, NSL, BLP, LTM) 
_ DENSITY . _s=s> 1600 (800, 1600, 6250) 


FILE POSITION 0. sees BO0UD (Pte 9999) ET 
STATUS OLD (NEW, OLD) 

NORMAL DISPOSITION CATLG (KEEP, DELETE, CATLG, UNCATLG) 
ABNORMAL DISPOSITION DELETE § (KEEP, DELETE, CATLG, UNCATLG) 
BLOCKSIZE 32760 (7892 to 32760) 

RETENTION PERIOD 9999 (1 to 9999 days) 


Vv 


v 


cn | 
Vv 


Vv 


MODEL DSCB DSN ===> 


VIEW OR CHANGE ADDITIONAL DUMP OPTIONS ===> Y (Y or N) 


USE ENTER TO CONTINUE; 
me ; USE HELP COMMAND FOR HELP; USE END COMMAND T0 EXIT..~.. -. ~ 





Figure 16. Page 2 of the DUMP Entry Panel 


Verify that the default values as shown in Figure 16 are acceptable and press Enter 
to display page 3. 


Note: A density is not required for a 3480 device type. The default density field is 
set to 1600. 


DUMP ENTRY PANEL Page 3 of 8 
COMMAND === 


SPECIFY ONE OR MORE DUMP CONTROL OPTIONS FOR VOLUME: LIBTST 


MAXIMUM NUMBER OF RETRIES 

NUMBER OF SECONDS BETWEEN RETRIES 
DUMP IN COMPRESSED FORM 

AMOUNT OF 1/0 BUFFERING 

RESET SOURCE CHANGED INDICATORS 


(0 to 99) 

(0 to 255) 

(Y or N) 

(1TRK, 2TRK, 5TRK, 1CYL) 
(Y or N) 


FOR 1/0 ERROR HANDLING, SELECT ===> 1 
1 TERMINATE IF ANY ERROR 2 TERMINATE AFTER 100 ERRORS 3 ALLOW ALL ERRORS 


FOR DATA SETS THAT INDICATE USED SPACE, SELECT ===> 1 
1 DUMP ONLY USED SPACE 2 DUMP ALL ALLOCATED SPACE 3 LIST DATA SETS 


FOR DATA SETS THAT INDICATE NO USED SPACE, SELECT ===> 2 
1 DUMP ALL ALLOCATED SPACE 2 DO NOT DUMP 


USE ENTER TO CONTINUE; USE DOWN COMMAND TO VIEW MORE DUMP CONTROL OPTIONS; 
USE HELP COMMAND FOR HELP; USE END COMMAND TO EXIT. 





Figure 17. Completing the DUMP Entry Panel 


Verify that the default values as shown in Figure 17 are also acceptable. Scroll 
forward if you want to view more entry panels, or press Enter if the field defaults 
are acceptable. If Enter is pressed, the DUMP Job Submission Entry Panel as 
shown in Figure 18 on page 30 is displayed. 
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ne ., DUMP JOB SUBMISSION ENTRY PANEL 
COMMAND ===> 


“SELECT’ONE OF THE FOLLOWING ==> 2 °°" ~ 
1 SUBMIT JOB FOR BACKGROUND PROCESSING 
2 SAVE GENERATED JOB IN A DATA SET 


IF OPTION "2" 15 SELECTED, SPECIFY: “200 2. wie 
DATA SET NAME ===> tape.dump 
REPLACE CONTENTS ===> y (Y or N) 





JOB STATEMENT INFORMATION: (verify before proceeding) 
=s=> //IBMUSERS JOB (account), 'name' 


VIEW OR CHANGE EXECUTE STATEMENTS FROM PROFILE ===> Y 


USE ENTER TO CONTINUE; 
[ + USE HELP COMMAND FOR: HELP; -USE END COMMAND :TO EXIT.x%-0. 80750 % 0 wee pot 





Figure 18. DUMP Job Submission Entry Panel 


You can change the default selection to save the DFDSS job stream, as shown in 
Figure 18. Press Enter to ciplay the DEDSS EXECUTE Statement Entry Panel, 
- Figure 19. 


DFDSS EXECUTE STATEMENT ENTRY PANEL 


SPECIFY DFDSS EXECUTE STATEMENT INFORMATION: 


* fT" 

aie A 

at Al 

> /{STEPI EXEC PGM=ADRDSSU, REGION=nnnnk 
> //SYSPRINT DD SYSOUT=* 


Hou w Wo 
boeuw uo tt 
neu w ton 


> //* 


at aa 


USE ENTER TO CONTINUE; 
USE HELP COMMAND FOR HELP; USE END COMMAND TO EXIT. 





Figure 19. DFDSS EXECUTE Statement Entry Panel 


Press Enter to save the job and redisplay the Volume List. The asterisk next to 
DUMP in Figure 20 on page 31 indicates that the job stream was successfully built. 
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+-VOLUME LIST - . ‘ 

SCROLL ===> HALF 
cs Entries 1-1 of 1 

ENTER LINE OPERATORS BELOW: Data Columns 3-8 of 39 


capa LINE VOLUME FREE .%  ALLOC . FRAG LARGEST FREE . . 
rer, sce OPERATOR » SERIAL '. SPACE -1s"FREE:. SPACE «INDEX EXTENT. EXTENTS cxesecpeoseef ccc cna se 
pe RH sates PRS gy caele Rep yee ce (gp se rage an(g)e= -(8)-==(7) ee a ae ae 
LIBTST 115845 19 506006 461 25296 
LIBOO1 100154 521697 300 
BOTTOM OF DATA 


a See Ee 


"USE HELP COMMAND FOR HELP; USE END COMMAND TO EXIT. 





_.. Figure 20. The DUMP Job Stream is Successfully Built 


For more information on using ISMF, see either ISMF User’s Guide or the ISMF 
online help panels. * 


Invoking DFDSS with JCL 


DFDSS is controlled by JCL statements and DFDSS commands. The JCL 
statements are used to invoke DFDSS and define the data sets used and created by 
it, whereas the DF DSS commands specify and control tasks. This section describes 
the JCL method of invoking and controlling DFDSS. This knowledge is needed 
even if you invoke DFDSS through an application program (as described in 
“Invoking DFDSS with the Application Interface” on page 36). 


The JCL You Need 
The following JCL statements can be used to invoke DFDSS: 


Statement Usage 
JOB (required) Initiates your job. 
EXEC (required) Specifies the program name (PGM =ADRDSSV) or, if 


the job control statements reside in a procedure library, 
the procedure name. You can enter additional 
information in the PARM parameter of the EXEC 
statement; see “Controlling DFDSS with the EXEC 
Statement” on page 33 following this list. 


SYSPRINT DD (required) Defines a sequential message data set. The data set can 
be written to a system output device, a tape volume, or a 
direct-access device. If the DCB keyword LRECL is 

specified on the DD statement, it must be in the ranges 

of 84 to 137 inclusive. If BLKSIZE is specified, it must 
be at least four greater than the LRECL. If an LRECL 
less than 84 is chosen, the return code is 8 and an error 
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| — | -- “s+. «message is issued.~If the specified LRECL is ‘greater’ “" 
} ee < | _« io __. than 137, then LRECL and BLKSIZE are set to 137 and 


SYSIN DD (required) 


ae re Acne: ve yt BE: : £ 


SR Bipbens o EE eG 


input DD (optional) 


output DD (optional) 


- filter DD (optional) — 


password DD (optional) 


ec apenas acts Or ArTe rea ARE ren 
aE a TAN kage a ae nie Sp, 


‘ 








Be eta nies RB dS RS er a 
sugested area par Saye 


141, respectively. - | 
Defines a command data set, consisting of cards or 
card-image records, that contains your DFDSS 


commands, It usually resides in the input stream; ...... ...i« 
hee ys ee eT edie et Ce ae wy fa es ee vot ue & 


however; it can be defined as a ‘blocked or unblocked 
sequential data set or as a member of a partitioned data 
set. Records must be fixed format, LRECL = 80. 


Defines the input (also called source). The ddname, 
input, is supplied by you and is referred to by your 
DFDSS commands. This DD statement is not required 
for some operations. Do not specify BUFNO. | 


Defines the output (also called target). The ddname, 
output, is supplied by you and is referred to by. your 
DFDSS commands. This DD statement is not required 


for some DFDSS operations. Do not specify BUFNO. 


‘Code'a volume count when a new data set will reside on 
six or more volumes. (Note that DISP=MOD is not 
supported for an output DD statement.) 


~ Defines a data set, consisting of cards or card-image 


records, that contains the filtering criteria INCLUDE, 
EXCLUDE, and.BY) to be used in a data set command. 
The ddname, filter, is supplied by you and is referred to 
by your DFDSS commands. : 


Note: You cannot concatenate DD statements to the 
filter DD statement. 


Defines a data set, consisting of card-image records, that 
contains data set names and their passwords. The 
ddname, password, is supplied by you and is referred to 
by your DFDSS commands. 


For more information on coding JCL, see JCL Reference. 


The following example shows an input DD statement that specifies a DASD volume: 


//DASD DD UNIT=3380, VOL 





UME=(PRIVATE,SER=111111) ,DISP=O0LD 


The following example shows an output DD statement that specifies a tape volume: 


//TAPE DD UNIT=3480, VOL 


UME=SER=TAPEQ1, LABEL=(1,SL), 


// DISP=(NEW,CATLG) , DSNAME=USER2.DUMP 





A standard label tape is recommended to help prevent an operator error. If you use 


a label, you must include a 


32 DFDSS: User’s Guide 


corresponding DSNAME parameter. 
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The command data set, which is pointed to by the SYSIN-DD statement, contains » «| 


_. commands that specify operations to be performed (function commands) and 
_ commands that contre! = execution OF a Kopereuans (auxiliary commas): 


Controling DFDSS with the EXEC Statement 


vrases Be 2 2aS othe program. ° “You can use the following keyword parameters: -° 
TYPRUN =SCAN 
Only control card syntax checking is to be done. No tasks are to be executed. 


TYPRUN = NORUN 
For COPY, DUMP, RESTORE, COMPRESS, CONVERTV, and RELEASE 
operations, only data set filtering is to be done, without actually processing data 
sets. Printed output for the run indicates the data sets selected. For a 
DEFRAG operation, the initial volume statistics are to be printed, without 
actually relocating any extents. For a CONVERTV operation, a full report is 
produced, but no volumes or data sets are actually converted. 


- PAGENO = nnnn - de wt a 
The nnnn is a Le ‘to 4- digit Lae dicta’ the pontine page dumber t to ber 
used for the SYSPRINT data set. The default is 1. 


. LINECNT =npanD 
The nnnn is a 1- to 4- digit admber Sere the number of lines to be printed 
per page for the SYSPRINT data set. The default is 60. Specify 
LINECNT = 9999 to prevent a page ejection. | 


SIZE = nnonK 
The nnnn is a 1- to 4-digit number indicating the number of kilobytes (1 kilobyte 
equals 1024 bytes) of main storage to be used by DFDSS. This amount must be 
less than or equal to that specified by the REGION keyword. The default value 
is the region size. 


ABEND = nnn 
The nnn is a 3-digit decimal message number (ADRnnnx). If this is specified, 
and this message is to be issued, DFDSS executes a user 0001 ABEND dump 
after issuing the message, and the task is ended. To get a dump, include a DD 
statement for SYSABEND or SYSUDUMP. This keyword is provided for 
debugging purposes only. 


AMSGCNT = nnnn 
The abend message occurrence count that tells DFDSS to abend on the nth 
occurrence of the message specified in ABEND=nnn. The nnnn for 
AMSGCNT can be a number between | and 9999. The default is 1 (Ist 
occurrence). 


RACFLOG= YES 
RACF (Resource Access Control Facility) logging is done for all function tasks. 
This parameter can be overridden or set by the user installation options exit. 
See Data Facility Data Set Services: Reference for a description of DFDSS 
RACF logging. 


TRACE= YES 
When used during a DEFRAG operation, this results in messages being printed 
that indicate the relocated extents. This is a debugging tool. 


UTILMSG = YES 
Messages from auxiliary programs, such as IEBCOPY and ICKDSF, are copied 
into the DFDSS SYSPRINT output. 
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-XABUFF-= ABOVE16|BELOW16 ==) -.-ctecsis sane. ma. a EST Ett 
The I/O buffers used by DFDSS foe Copy, COPYDUMP, ‘DEFRAG, DUMP, 
PRINT, and RESTORE operations are to be above or below 16 megabytes 
virtual storage. The default, when running under MVS/XA, is “ABOVE16”. 
This parameter is ignored when running under MVS/370. 


gy oReau workunit ». cog chin a > . 
« Youcan. “supply an’ ‘esoteric DASD. anita ‘name: se oe eae SYSDA). | generic 
DASD unit name (for example, 3380), or a specific DASD address. DFDSS 


passes this unit to dynamic allocation when temporary data sets are allocated. 


WORKVOL = volser 
You can supply a volser on which DFDSS should allocate temporary data sets. 
DFDSS passes the velser. is dynamic aliorston: 


Notes: 


1. WORKUNIT, WORKVOL, or both parameters can be specified when you 
invoke DFDSS. 


2. When DFDSS invokes the IDCAMS utility to copy an ICF user Catalog, the 

’ ~ export data set is allocated as a permanent data set.” The permanent data set 
cannot be placed on the volume specified by WORKUNIT and/or 
WORKVOL. 


3. An esoteric unit name that requests virtual I/O can be used in the 
WORKUNIT parameter, but when DFDSS invokes the IEHMOVE utility 
during data set copy, the default dynamic allocation unit name is used |. ~ 
(SYSALLDA), 


Examples of PARM information are: 


// &XEC PGM=ADRDSSU, 
/f PARM='PAGENO=8, LINECNT=57 , SIZE=500K,UTILMSG=YES ' 


// =XEC PGM=ADRDSSU, PARM='TYPRUN=SCAN, XABUFF=ABOVE16' 


For further information on the PARM parameter of an EXEC statement, see 
Application Development Guide. 


Examples of Invoking DFDSS with JCL 


Following are some examples of JCL job streams for invoking DFDSS. 


Note: Devices Available: Throughout the examples in this manual, devices are 
presented as UNIT = 3350 or UNIT = 3380, and a tape device as UNIT =3480. This 
is for illustration only; you can specify any supported DASD device and any 
supported tape device. Refer to System Generation for the device-type notation to be 
used in the UNIT parameter of a DD statement. 


Moving a Data Set: The following example shows how to move a data set from one 
DASD volume to another using JCL and a DFDSS command. The source data set 
is deleted and the target data set is cataloged to reflect its new location.4 


4 This JCL must be removed when working in an SMS-managed environment. 
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//MY30B JOB accounting information, REGION=nnnnk — 
//STEP1 EXEC PGM=ADRDSSU 


//SYSPRINT DD —- SYSOUT=A é 

//DASD1 DD UNIT=3350 ‘VOL=(PRIVATE, ennai: DISP=0LD 

//DASD2 DD UNIT=3380 Sea SER= oe DISP=OLD 

//SYSIN: . DD oR pays ABLE he oy fied $4 ne Beg herbs : ae eb 

COPY DATASET(INCLUDE(MYDATSET)) a ica: eee 
LOGINDDNAME(DASD1) OUTDDNAME(DASD2) DELETE CATALOG 

f= 





Dumping a Data Set: This example shows how to back up a DASD data set® to 


//MYJOB JOB accounting information, REGION=nnnnk 

//STEPI EXEC PGM=ADRDSSU 

/{SYSPRINT DD... SYSOUT=A ... sate. obits 
//DASD © DD‘ * UNIT=3380 ,VOL=(PRIVATE, SER=111111), DISP=OLD. 
//TAPE DD UNIT=3480, VOL=SER=TAPEO1, 


// LABEL=(1,SL) ,DISP=(NEW,CATLG) ,DSNAME=MYDATSET . BACKUP 
J/SYSIN- DD * 
DUMP DATASET(INCLUDE(MYDATSET)) - 


INDDNAME(DASD) OUTDDNAME(TAPE) 





Restoring a Data Set: In this example, the data set) (MYDATSET) that was backed 
up on tape in the “Dumping a Data Set” example is restored to the original DASD 
volume on which it resided. 














| //MYJOB JOB accounting information, REGION=nnnnk 
i //STEPL EXEC PGM=ADRDSSU 
//SYSPRINT DD SYSOQUT=A 
//TAPE DD UNIT=3480, VOL=SER=TAPEOL, 
// LABEL=(1,SL) ,DISP=(OLD,KEEP) ,DSNAME=MYDATSET. BACKUP 
//DASD DD UNIT=3380, VOL=(PRIVATE, SER=111111) ,DISP=OLD 
//SYSIN. DD * 

RESTORE DATASET(INCLUDE(MYDATSET)) - 

INDONAME (TAPE) OUTDDNAME(DASD) REPLACE 

il 





5 Do not use a data set name that DFDSS will reference during execution. Otherwise, enqueue contention with the 
operating system initiator will occur. 
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You can invoke DFDSS from. an application program by using z the application 
interface. This allows you, for example, to gather statistical-or auditing information, 
and to specify control variables. 





cove bar aw er 


e Fully utilize the invocation capabilities of DEDSS when the ATTACH, LINK, 
or CALL system macro is specified in your application program. 


e Optionally, specify a list of parameters to be used by DFDSS during the 
processing caused by that invocation. 


¢ Optionally, interact with DFDSS during processing of user installation options 
after the installation options exit has been called. 


¢ Optionally. interact with DFDSS during the processing at convenient points 
where input/output (I/O) operations are being performed. 


Note: DFDSS runs as an authorized problem program (nonsupervisor State); any — 


_ program invoking-DFDSS must also be authorized and in nonsupervisor state. 


For more information on the application interface, see Data Facility Data Set 
Services: Reference. 


- User Interaction Module Exit Functions - 


When DFDSS is invoked Ponta an apelaion program, you can use the user 
interaction module (UIM) to interact with DFDSS at points where I/O operations 
are being performed. UIM exit functions can be used to: 


¢ Replace, insert, delete, or modify a SYSIN record after DFDSS reads it or a 
SYSPRINT record when DFDSS is ready to print it. 


¢ Replace, insert, delete, or modify a write-to-operator message before DFDSS 
writes it. 


e Insert a statistics record during a logical DUMP. 


¢ Modify the installation options specified in the ADRUFO control block to 
override the specified options. 


e¢ Bypass password and expiration date checking, or reject the tape volume and 
request a scratch tape, when DFDSS is ready to open a tape. 


¢ Request a specific volume serial when a nonspecific tape is passed to DFDSS. 
¢ Get information about the data set being allocated. 
¢ End a task or processing of individual data sets. 


¢ Bypass authority checking for individual data sets. This includes both RACF 
and password authorization. 


e Bypass serialization checking of individual data sets. 


For more information and examples of UIM exit functions, see Data Facility Data 
Set Services: Reference. 
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Chapter 6. Protecting DFDSS ae a 


‘This chapter discusses the functions of DFDSS to which you can control access by 
using RACF. You can protect DFDSS/ISMF functions and some DFDSS 
KEN HORS. 
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Protecting DFDSS/ISMF Functions with RACF 


Using the program control feature of RACF Version | Release 7 or later releases, 
you can set authorization levels for ISMF functions: ISMF itself, each of the ISMF 
applications, and the individual line operators and commands. In addition, each 
_ISMF function you identify to RACF for authorization checking is included in the 
RACF report and logging process. You can also use standard RACF authorization 
checking to limit access to individual data sets, volumes, or catalogs. Used in 
conjunction with program control, authorization checking ensures that the 
appre ete ate data and pupeueRs are evalablc to users nen they need them. 


-ISMF Functions vou Might V Want to Protect 


Program control allows you to determine the ISMF functions to which users have 
access. The authorization scheme you set up can apply to both individual users and 
user groups. The DFDSS functions you can protect fall into two general categories: 
line operators and commands. 


With program control, you can set up authorization levels for each category. You 
can also vary the level within a category to suit the needs of your site. Before you 
set up an authorization structure, you might want to consider the following: 


Do you want all users at your site to have access to ISMF? 


Do you want all users to have access to the data set, volume, or profile 
applications? 


Are there line operators or commands to which you want to limit access? 


Setting Up the Authorization Structure | 
RACF program control checks authorization before allowing access to an ISMF 
function. Protection for each function is based on the authorization level of the load 
module that contains the function. A user is allowed to execute an ISMF function 
(the RESTORE list command, for example) when one of the following 1s true: 


The user is authorized to execute the load module corresponding to the function 
requested. Authorization is defined as READ level access or greater. 


The user’s RACF profile has the OPERATIONS attribute. 
The user’s group is authorized to execute the load module. 


The universal access authority (UACC) for the load module is READ or greater. 
This makes the load module available to anyone who can access ISMF. 
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The names of the load modules for DEDSS/ISMF are stored i in command. tables i in. 
both the panel library, DGTPLIB, and the load library, DGTLLIB. The load 
module names are listed in Figure 21 and Figure 22. The.module names are found * 
in the DGTSMMDI1 member of the panel library. 


Figure 21 lists the names for: the corresponding line” operators." The ‘module names *; 
for line operators are found in the DGTTLPD3 member of the load library. 


Figure 22 lists the names for commands. These names are in the DGTTCTD2 
member of the load library. 


Data Set Application Volume Application 


Line Operator Module Name Module Name 
COMPRESS DGTFCM01 DGTFCSO01 
CONVERTV ~ DGTFCNO1 
COPY DGTFCY01 DGTFCV01 
DEFRAG — had _DGTFDFO1. 
DUMP | - DGTFDPO1 | DGTFDM01 
RELEASE DGTFRLO1 DGTFRVO1 
RESTORE | _.'* DGTFRTO1. == .. DGTFROO! 


meee 21. Module Names for pias unset Line oo 


Command Module Name 
COMPRESS DGTFCP01 
COPY DGTFCOO01 
DUMP DGTFDU0O1 
RELEASE DGTFRE01 
RESTORE DGTFRROO 


Figure 22. Module Names for DFDSS/ISMF Data Set Application Commands 


To view the command table, you need to know the data set names your site uses for 
the panel library and the load library. The installation of DFDSS/ISMF puts the 
panel library in SYS1.DGTPLIB and the load library in SYS1.DGTLLIB. 

However, your site’s post-installation procedures might involve moving the 
DFDSS/ISMF libraries. If they were moved, you can determine the data set name 


~ by issuing the TSO LISTALC command and scanning the low-level qualifiers for 


DGTPLIB and DGTLLIB. 


38 DEDSS: User’s Guide 


2 ang ae 


Lape oe 








Eh eae wR? Sis bese? ee Spano heen eats SSE I ot aR ; Teese OREN Sr ana Reyes, we Cte Petatie reat ad tee SES ER sia? Legere bo tare Rees 
vee feats See a oe. Jebel ‘Pees Ww a ara Sere: Sa Ee PRC? mins “Rend ag at Oo hacks Re A Ake | ali pig aes le, wate pple p Oh. . 


Protecting DFDSS/ISMF Modules = 0 7 0 se Ra EA dna 
The two steps to protect DFDSS/ISMF siodtiles: are: : | 


1. To define the modules you want to protect, use the REDEFINE command or 
the ISPF RACF entry panels. When you define the modules to RACF, supply 
the name of the load module you want to protect, the name of the data set that 
- contains the module, and the volume serial number of the volume containing the x. 
data set. Each module you identify is added to thé profi le for the PROGRAM ~ 
general resource class. You have several options when you define modules: 


¢ If you want to define several modules at the same time, you can use asterisk 
notation. For example, DGT* means all the modules beginning with the 
letters DGT. 


¢ You can add an access list with user [Ds and/or group names with their 
associated access authority to the profile. 


¢ You can define the UACC to give default access to all users or to none. 
e You can use the AUDIT parameter to set up RACF logging or to bypass it. 


2: To allow usérs to éxecute an application, line operator, of command, use the 
PERMIT command. 


For more information on how to perform these steps and the ePHous yee have using 
program control, see RACF Security Administrator's Guide. 


DFDSS i You Can Protect with RACF 


n addition to protecting DFDSS/ISMF functions, you can also protect certain 
epee keywords. Ifa profile is not set up for these keywords, then anyone can use 
the keyword. Figure 23 lists these keywords and their associated RACF facility 
class profiles: 


Keyword Profile Name 
BYPASSACS with COPY STGADMIN.ADR.COPY.BYPASSACS 
BYPASSACS with RESTORE STGADMIN.ADR.RESTORE.BYPASSACS 
CONVERTV STGADMIN.ADR.CONVERTYV 
INCAT(catname) with DUMP STGADMIN.ADR.DUMP.INCAT 
INCAT(catname) with COPY STGADMIN.ADR.COPY INCAT 
PROCESS(SYS1) with COPY STGADMIN.ADR.COPY.PROCESS.SYS 
PROCESS(SYS1) with DUMP STGADMIN.ADR.DUMP.PROCESS.SYS 
PROCESS(SYS1) with RELEASE STGADMIN.ADR.RELEASE.PROCESS.SYS 


Figure 23. RACF Facility Class Profile Names for DFDSS Keywords 


Refer to RACF Security Administrator’s Guide for additional information on RACF 
facility class profiles. 
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Chapter 7. Managing Availability with DFDSS 


One of the major functions 6f DFDSS is the backup and recovery of data. Using 
the DUMP and RESTORE commends you can PACKED and recover data sets and 
volumes.‘ 6 


vee it OR He PT gers, 


oe, 


Het teed ‘e 1 “ie ae See omy uae Hae V ag oy PR ee Tete etary: SM yale 
2 ot Wake ee ee Ee me é ot aa : y we Be 





This caper iS organized a as (ilewe 


e “Planning an Availability Strategy” discusses the various considerations for an 
overall availability strategy. This section also describes disaster recovery 
requirements, vital records storage, and archived data sets. 


¢ “Backing Up Data Sets” on page 45 describes how to use DFDSS to back up 
data sets to meet your general backup requirements. — . 


¢ “Backing Up SMS-Managed Data Sets” on page 51 describes how to use 
DFDSS to back up data sets in a SMS environment. 


¢ “Backing Up Volumes” on page 51 describes how to use DF DSS to back up. 
*-"“volumés to méet your general backup requirements. °° “e 


¢ “Restoring Data Sets” on page 53 describes how to use DFDSS to recover data 
sets and volumes to meet your general recovery requirements. 


Planning an Availability Strategy | 


In planning your overall availability strategy, you should consider the following 
types of backup: 


Backup of volumes and data sets—The general type of backup to guard against 
users accidentally losing or incorrectly changing their data sets and against 
losing volumes due to hardware failures. 


Disaster recovery backup—Backup to protect against the loss of all your data in a 
major disaster at your site. These backups are stored off site and, in the event 
of a major disaster, are recovered at another site. 


Vital records backup—Backup copies of data sets kept to meet externally imposed 
retention requirements, such as tax records. 


Archival—Backup of data that is unused for a long period of time. You remove 
the data from DASD and retain it on tape in case it is needed again. 


DFDSS is a very flexible backup and recovery tool. You can use DFDSS by itself 
to perform all backups listed above or to complement other backup and recovery 
tools. 


Note: If you have a 3480 tape drive with the Improved Data Recording Capability 
(IDRC) and you want to use hardware data compaction, you do not need to use the 
COMPRESS keyword with the DUMP command. If you want software 
compression, specify the COMPRESS keyword, but do not specify 

DCB=TRTCH =COMP in the JCL. 


6 You can also use DUMP and RESTORE on ranges of tracks. However, this is usually done as a means of 
diagnosing I/O errors rather than as a means of backing up and recovering data. 
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For data set backup, you need to consider the frequency of backup and the number 
of versions you want to keep. A number of factors can influence the frequency of 
backup and the number of versions to be kept, such as: 


¢ The rate at which the data changes. 


e The ease or difficulty of rebuilding the data (for example, it is easier to rebuild 
an object library than a source library). 


¢ The importance of the data. For data that is extremely important to your 
business, you might want to keep extra backup versions. 


These are.only a few of the things you must consider when determining frequency of ~- 


backup and number of versions. A more complete discussion of these considerations 
can be found in SML: Managing Data Sets. 


Volume backup is necessary to guard against losing a volume, but it need not be 
done as often if you are doing incremental backup on a regular basis. If you lose a 
volume, you can recover from the latest volume backup, and then recover data sets 
from incremental backups to return the volume to its status before the failure. This 
form of recovery is sometimes referred to as forward recovery. In order to perform 
it, though, you must have a record of all your backups. Data Facility Hierarchical 
Storage Management (DFHSM) keeps its own inventory of the data sets it backs up 
and can perform forward recovery using that inventory. DFDSS prints the names of 
the data sets it dumps and the serial and data set sequence numbers of the tape 
volumes on which the dump begins and ends. You must use this printed record to 
perform forward recovery with DFDSS. 


Backup and Recovery in an SMS Environment 


Two kinds of data exist in an SMS environment: SMS-managed and 
non-SMS-managed data. DFDSS can help you fulfill your availability ees 
for both kinds of data. 


SMS-Managed Data: If you have Data Facility Hierarchical Storage Management 
(DFHSM) installed, it can perform automatic volume backup (by invoking DFDSS) 
and incremental backup on SMS-managed data. Each data set is assigned a 
management class that indicates how often DFHSM should back it up and how 
many versions of the backup to keep. Using DFHSM this way allows you to 
manage availability at the data set level. 


If you do not have DFHSM installed, you can use DFDSS to back up and recover 
data sets and volumes. By filtering on management class name and the 
data-set-changed flag, you can perform incremental backup on all the data sets 
belonging to a particular management class. To automate this backup procedure, 
you can set up a DFDSS job to run periodically. 


For more details on planning for backup of SMS-managed data, see SML: 
Managing Data Sets. 
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-: Non-SMS-Managed Data: «Typically, non-SMS-managed data is data that SMS does 

_ not support or data that is in transition from non-SMS to SMS management. If it is 
data that SMS does not support, you can probably still use DFDSS to back it up 

.,and recover it, because DFDSS supports many kinds of data that SMS does not. If. 
it is data in transition to SMS management, you can use DFHSM or DFDSS to 
back ud and recover it bart it is aoa under SMS mianagement: 
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Backup and Recovery i ina Non-SMS Envisentont: i: a aaa a 

If you do not have MVS/DFP Version 3 Release 1 or if you do have it but SMS is 
not active, then you are in a non-SMS environment. For availability management, 
the data in this environment can be treated much the same as the non-SMS-managed 
data in a SMS environment. DFDSS can be used to back up and recover it at the 
data set and volume level. 


Disaster Recovery 
Disaster recovery backups are made specifically for recovering data and applications 
following a disaster. Never rely on your regular backup data sets (for instance, 
DFHSM or DFDSS incremental backups) for disaster recovery. Disaster peor, 
‘ backups require some very special considerations that normally do not apply to - 
other types of backups. 


Store at a Remote Site: A basic difference between regular backups and disaster . . 
recovery backups is that disaster recovery backups must be transported to a different 
site. How remote the recovery site is depends upon the type of disaster you are 

preparing for (in the case of a fire, the recovery site can be around the corner; in the 
case of an earthquake or flood, it should be many miles away). The fact that the 
backups must be taken to another site means that they must be on a portable media: 
tape. 


Note: It is also possible to transmit backups to another site. 


Use Logical Data Set DUMP: Because the environment at the remote site might 
differ from your environment, you should ensure that your disaster recovery backups 
can be restored in a different environment. In general, it is recommended that you 
use logical data set DUMP and filter on data set name to make disaster recovery 
backups. Logical data set DUMP allows you to back up only your critical data sets 
and restore to unlike devices. 


Making logical data set dumps for disaster recovery backup requires a naming 
convention or some other method to identify your critical data sets. If, for example, 

| you establish the convention of having the letters CRIT as the first four characters in 
the first qualifier of critical data sets, you can back them up for disaster recovery as 
follows: 


DUMP - 
DATASET (INCLUDE(CRIT*.**) - 


BY (MGMTCLAS,EQ,MCNAME)) - 
QUTDDNAME(TAPE)  - 
COMPRESS 





If for some reason you must do volume dumps for disaster recovery, you should at 
least do logical volume dumps instead of physical volume dumps. This allows you 
to restore the backups to unlike devices. You can perform logical volume dumps by 
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-.. Only Back Up Critical Data Sets:. You should back up only data sets that are™ 


critical to your operation. For example: 


Critical application data sets 
DFHSM ‘control data sets © 
RACF inventory data sets 
System data sets 

Catalogs. 





Because you normally back up only critical data sets for disaster recovery, the 


amount of data you have to back up is only a small percentage of all your data. To -— 


identify those data sets you want backed up for disaster recovery, you should create 
a unique naming convention. 


To maintain versions of your disaster recovery backups, you can use generation data 
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F or more ilonaaton on sdisaster recovery, see SML: Managing Data Sets. 


Vital records are maintained to meet ad retention a couch as ategal 
requirements). 


Like disaster recovery backups, vital records are kept at a remote site and therefore 
should reside on tape. Vital records are usually an even smaller percentage of all 
data than disaster recovery backups. Unlike disaster recovery backups, vital records 
are rarely necessary for normal processing. 


Vital records are usually kept for long periods of time. As a result, the device they 
originally resided on may no longer be in use at the time of recovery. In that case, 
you will need to restore them to unlike devices. For this reason, vital records should 
be dumped iogically so they can be restored to unlike devices. As with disaster 
recovery, using logical data set DUMP requires a naming convention or some other 
method to identify data sets for dumping. 


If, for example. you establish the convention of having the letters VR as the first two 
characters in the first qualifier of data sets to be backed up for vital records 
purposes, you can dump them as follows: 


| 


DUMP - 
DATASET (INCLUDE(VR*.**) - 
BY (MGMTCLAS,EQ,MCNAME)) - 
OUTDDNAME(TAPE) - 
COMPRESS 





For more details on vital records, see SML: Managing Data Sets. 
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Archived data sets are data sets created. to. remove data from active status. This 
data is placed on alternate storage media because it is not currently being used but 
may be used in the future. Archived data sets are usually used for long-term . 
retention. 


You can tse DFDSS to archive data sets by periodically filtering on last referenced .. - 
date and then dumping and deleting data sets that have gone unreferenced for long 
periods of time. This frees up space for data that is being accessed more frequently 
and requires the faster access time of DASD. Because archived data sets might not 
be recovered for a long period of time, they should be dumped logically so they can 
be restored to unlike devices. 


For example, the following logical DUMP command results in the archiving of all 
data sets in management class MCNAME! that have not been referred to since 
April 10, 1986: 


are ae 


oh tae 


He ee A ee ee ee 
DATASET(BY((REFDT LT 86100) (MGMTCLAS EQ MCNAME1))) - 
OUTDDNAME(TAPE1)  - 


DELETE -. 
COMPRESS - 
PURGE 





For more details on archiving, see SML: Managing Data Sets. 


Backing Up Data Sets 


With the DUMP command, you can dump DASD data to a sequential data set. 
The storage medium for the sequential data set can be tape, DASD, or mass storage 
virtual volume. 


DFDSS can dump data sets both logically and physically. Data sets are located by 
searching either the catalog or the VTOC. 


You can select data sets for DUMP and RESTORE processing based on data set 
names and numerous data attributes, as discussed in “Choosing Data Sets for 
Processing—Filtering” on page 13. If you want to perform incremental backups 
with DFDSS, you can filter with BY(DSCHA.EQ.1) to dump only data sets that 
have changed since the last dump was taken. If you also code the RESET keyword, 
DFDSS changes the data-set-changed (DSCHA) bit after successfully dumping the 
data set. 


Notes: 


1. If you are using DFDSS on data sets that DFHSM is also backing up, you 
should not use the RESET keyword because 1t might cause confusion as to 
which backup is the most current. 


bo 


. DFDSS does not preserve candidate volumes during DUMP processing. 
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The data-set-changed bit and the last-referenced date aes are iia for: * 
‘© Non-VSAM data sets. ee 
. © .VSAM data sets in the DFP environment if: you: 


—- Have DFHSM, or 
— Replace the installation exit ADATMSTP. with one that Sets, RC = 
apes, tg ESBS: isin phe Sets EE BS yee ay ti ees Be a 
Tenporey data sets that are created and deleted by other ‘abs running at the same 
time DFDSS is running might be included in the data set list at the beginning of a 
DFDSS job, and might disappear at a later time before DFDSS finishes. DFDSS 
can issue a message informing the user what happened only at the time DFDSS tries 
to access the data set. If the user wants to hold all the data sets in a volume for the 
_entire DFDSS execution then the user must write an enqueue installation exit to 
enqueue the volume for the entire job. 


When you create backups of data sets with DUMP, you can make multiple (up to 
255) dump copies with a single DUMP command. This is done by specifying 
multiple ddnames on the OUTDDNAME parameter. To specuy multiple. eopaine® 


* on the OUTDDNAME parameter, you might code: 


DUMP -- , 
DATASET (INCLUDE(**) = 


_BY(MGMTCLAS,EQ,MCNAME1)) . - 
OUTDDNAME (TAPE1,TAPE2,TAPE3) - 
COMPRESS 





This technique can be helpful if you want to create several backup copies to be used 
for different purposes. 


Unless overridden by the installation options exit routine, DFDSS continues 
dumping while at least one output copy does not have an output error. 


Logical Data Set DUMP 


If you specify DATASET with the DUMP command and do not specify input 
volumes, DFDSS performs a logical data set DUMP using information in the 
catalog(s) to select data sets. For instance, the following DUMP command results in 
a logical data set dump: 


| DUMP - 


DATASET ( INCLUDE (**) 
BY(DSCHA,EQ,YES)) - 

OUTDDNAME(TAPE1) - 

COMPRESS 





If you specify DATASET and either LOGINDDNAME or LOGINDYNAM, 
DFDSS performs a logical data set DUMP using information in the VTOC(s) to 
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DUMP - 
DATASET (INCLUDE (**) ) -. . ; 
women [Sy LOGINDYNAM(338001) no: tee ee ot age Mlteton my 
meV OUTDDNAME(TAPE) - =~ eee 
COMPRESS 





DFDSS logical DUMP processing cannot be used to process PAM data sets 
containing location-dependent information that does not reside in note lists or the 
directory. As an example, PDS load libraries that contain overlay modules are not 
supported during logical DUMP processing. 


As already discussed, logical processing offers the advantage of device independence. 
A pada data set saa can be restored to both like and unlike devices. 


Physical Data Set DUMP 
If you specify DATASET and INDDNAME or INDYNAM, DFDSS performs a 
physical data set dump. For instance, the following DUMP command results in a 
physical data set dump: 


INDDNAME(DASD1) OUTDDNAME(TAPE) - 


DATASET(INCLUDE(**))  - 
COMPRESS - 
OPTIMIZE(4) 





When multiple input volumes are specified for a physical data set DUMP, multiple 
logical files (logical volumes) are created for each phvsical DASD source volume. 


DFDSS facilitates backup and recovery procedures for physical data set dumps by 
printing the names of data sets dumped, and the serial and data set sequence 
numbers of the backup tape volumes on which the dump of a DASD volume begins 
and ends. 


Note: DFDSS does not support any physical dump processing of a KSDS with key 
ranges. Logical processing should be used for this type of data set. 


A Backup Scenario 
As discussed under “Backup and Recovery” on page 42, you should consider using a 
combination of incremental and volume backup to fulfill your general availability 
requirements. One possible way of implementing this strategy is: 


1. Dump a full volume at a given interval—perhaps once a week. You should use 
the RESET keyword to reset the data-set-changed flag. To do full volume 
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_dumps of two volumes at once (in parallel, which is, most effective if tapes are on « 
peisetes channels), code the following: : 








PARALLEL 
DUMP INDYNAM(111111) OUTDD(TAPE1) RESET OPTIMIZE(1) 





Re ny OK! 





2. Dump only changed data sets at a shorter interval—perhaps every day. 


DUMP LOGINDY( (111111) , (222222) ) QUTDD(TAPE3) RESET - 
~~ OPTIMIZE(3) DATASET(INCLUDE(**) - — 
BY ( (DSCHA,EQ, YES) )) 





3. Use data set naming conventions to set up a dumping scheme that takes account 
of the relative importance of the data. -For example; include CRIT“in the =>: 
first-level qualifier of all your critical data sets. With this convention in places 
you can back up your critical data sets as follows: 


DUMP LOGINDY((111111),(222222)) OUTDD(TAPE4) RESET - 


OPTIMIZE(4) DATASET (INCLUDE (CRIT*.**) - 
BY (DSCHA, EQ, YES) ) 





Other naming conventions can also be used to identify groups of data sets. For 
instance, you can use department numbers, charge numbers, user initials, or 
project codes to identify data sets you want to dump together. For more 
information on naming conventions, see SML: Managing Data Sets. 


SYSPRINT contains the names of all the data sets that were dumped for each run. 
You will have to keep them for reference if you have to restore a data set and you 
want it to be at the latest level. If you misplace the previous dump SYSPRINT, you 
can discover what data sets are on a particular dump tape by executing a RESTORE 
operation with the NORUN parameter on the EXEC statement and 
DATASET(INCLUDE(**)). 


This prints a listing of all the data set names on the restore tape, and you can now 
find the latest dumped version of a particular data set. 


Backing Up Data Sets with Special Requirements 


Some data sets require special processing when they are backed up. The sections 
below discuss backing up multivolume data sets and integrated catalog facility user 
catalogs. 
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_ Dumping Multivolume Data Sets 


An important advantage of DFDSS as a backup ‘tool is ; that it can back up 
multivolume data sets without having to specify any or all of the input volumes. 

The catalogs are scanned to select an entire data set; that is, the data set is processed 
in its entirety from all the volumes it resides on. Logical processing consolidates the 
extents of the data set in one cump data set for yet 


ee es ie PA mre a os rs ru ie ieee 


ete if you specify ‘the’ ALEMULTE eT “and yeas Sones ‘DFDSS Fee the’ feo 
entire multivolume data set even if you do not specify all the volumes on which the 
data set resides. To use ALLMULTI, the data set must be cataloged and at least 
one primary volume must be specified on the LOGINDDNAME or 
LOGINDYNAM volume list. 


Following is an example of the DUMP command with ALLMULTI specified: 


ae - 
ALLMULTI.. = oo on 


LOGINDYNAM (338001) i. 
OUTDDNAME(TAPE)  - 
COMPRESS 





_ Note that ALLMULTI works only for logical data set dumps. If you dump a 

" multivolume data set physically, you must make sure the segments from all the 
volumes are dumped together. If you dump a multivolume data set physically, it is 
dumped from all the volumes that are passed. The output dumped data contains a 
logical file for each selected volume. 


A multivolume data set standard user label is not supported. 


Dumping Integrated Catalog Facility User Cataiogs 
Another important use of DFDSS as a backup tool is the backing up of integrated 
catalog facility user catalogs and their aliases. The user catalog name must be 
fully-qualified with the INCLUDE keyword on the DUMP command. With 
MVS/XA DFP Version 2 Release 3 and later releases, the LOCK attribute of an 
integrated catalog facility user catalog is dumped. The LOCK status is preserved if 
the catalog does not exist at restore time. Otherwise, the LOCK status of the 
existing catalog is used. See Catalog Administration Guide for a description of the 
LOCK attribute. 


The following example shows the JCL used to dump an integrated catalog facility 
user catalog. The master password is required to dump the catalog. Passwords are 
not required if you have RACF DASDVOL update access or if the installation 
authorization exit bypasses authorization checking. 
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//SYSPRINT DD ‘sysouT=* 4 
T/TAPE DD WOL=SER=TAPEO1 ,UNIT=3480, ABEL (3K NL) sD1SP=(NEW, cATLS) 5 

// . DSN=BACKUP.CATALOG ~ - 

//SYSIN. DD * 

DUMP OUTDD(TAPE) - 

aes _ DS(INCL (TEST. CAT.USERCAT)),,<.. 

vege ce | PRS TERY pow (USER: CRT /OSERMPWL) DAE - 


j* 





Figure 24 shows printed output produced by the dump 


PAGE Q661 DFOSS 5665-327 DATA FACILITY DATA SET SERVICES V2R5.0° 89.069 18:58 


DUMP OUTDD(TAPE) - 
DS(INCL(TEST.CAT.USERCAT)) - 
PSWD (TEST .CAT.USERCAT/) 
ADRIOLI RIQ1 (01), TASKID 001 HAS BEEN ASSIGNED TO COMMAND ‘DUMP ' 
ADR1091 R11 (01), 89046 10:30:38 INITIAL SCAN OF USER CONTROL STATEMENTS COMPLETED. 
ADROOGI (001)-SETUP(O1), 89046 10:30:38 EXECUTION BEGINS 
a eee e ADR4541 (0@1)-DTOSC(O1), THE FOLLOWING DATA.SETS WERE SUCCESSFULLY: PROCESSED. -= <7 yor yorey see 
gy ae TEST.CAT.USERCAT: © ff PE Bee Pitts 
ADRO131 (001)-CLTSK(01), 89046 10:32:24 TASK COMPLETED WITH RETURN CODE 0000 
ADROL2I DSSU (01), 89046 10:32:25 DFDSS PROCESSING COMPLETE. HIGHEST RETURN CODE IS 0000 





Figure 24. Output From a Dumped Integrated Catalog Facility User Catalog © =: 


Note: F é . <. a c bettas tae : ete ‘ 
e A ionic dat set dais cannot fb used to dunie the master catalog unless a 
master catalog is first redefined as a user catalog. 


¢ Data set passwords are suppressed and do not appear in the output. 


Dumping VSAM Spheres 
With DFDSS Version 2 Release 4, it is possible to dump an entire VSAM sphere 
(base cluster and all associated alternate index clusters and paths). The SPHERE 
keyword causes DFDSS to dump the entire VSAM sphere. To dump the base 
cluster and the other components, all you need to specify is the base cluster name. 


An example of the DUMP command with the SPHERE keyword is: 


OUTDDNAME(TAPE) - 
DATASET (INCLUDE(PARTS.VSAM1))  - 


SPHERE - 
PSWD(PARTS.VSAM1/MASTUPW1)  ~- 
COMPRESS 





| Note: You should be aware that you cannot restore a sphere unless it is dumped as 
| a sphere with the SPHERE keyword. 


| The PDSE cannot be dumped on a system using releases prior to DFDSS Version 2 


| Release 5, nor can they be dumped on a system using releases prior to MVS/DFP 
| Version 3 Release 2 and MVS/SP Version 3 Release 1.0E. 
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Buiising SYS1 System Data Sets...» 


With the PROCESS keyword i in niGdnjnneton with the SYS! subkeyword, you can - 


~ delete datasets, except for a VVDS or a VTOCIX, when performing a logical or a 


physical data set dump. 


To limit the use of PROCESS, you need to set up a RACF cao class pio’ 
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“(Backing Up SMS- aanaged Data Sets 


When backing up data sets in an SMS environment, you need to think about some 
special conditions in addition to those discussed under “Backing Up Data Sets” on 
page 45. The following sections discuss how you can back up SMS-managed data 
sets in an SMS environment. | 


In most cases, you should let DFHSM back up SMS-managed data sets for you. 
However, if you do not have DFHSM or you prefer not to rely on it for all your 
backup requirements, you can use DFDSS to back up your SMS-managed data sets. 


‘Filter on Class Names: DFDSS can select data sets for DUMP processing based on 


their storage, management, and data class names. Because management class is the 
construct that contains a data set’s availability attributes, you a want to filter on 
it when selecting data sets for DUMP processing. i. 


.. If you wish to back up data sets in a particular management class, you can filter on 

- the management class name. For example, if you want to perform incremental 
backup on data sets in management classes MCNAMEI and MCNAME?, specify 
the DUMP command as follows: 








DUMP - 
DATASET(INCLUDE(**)  - 
BY ((MGMTCLAS ,£Q, (MCNAME1,MCNAME2)) (DSCHA,EQ,YES))) - 
OUTDDNAME (OUTVOL1) 


Class Names Saved: DFDSS saves the class names of the data sets it dumps. 
These names are then used as input to ACS routines when the data set is restored. 


Backing Up Volumes 


With DFDSS, you can back up volumes either logically or physically. If the volume 
is to be restored to an unlike device, you must dump it logically. 


Logical Volume DUMP 


To perform a logical volume dump, you specify DATASET(INCLUDE(**)) and 
either LOGINDDNAME or LOGINDYNAM. LOGINDDNAME identifies the 
input volume that contains the data set(s) to be dumped. LOGINDYNAM specifies 
that the volume(s) containing data sets to be dumped be dynamically allocated. 


Chapter 7. Managing Availability with DFDSS 51 





BPA Cate Lee ener tiara digell ci POG Pee be Y 

peeves seep SAA NE SA ERE tet uras feng Sy eracnerrees mabe Naot hg Logs 

Bees Tee oy Ee cake SN 2 RE ena, Wyeeey Ligne’ ace pate “te hee gone PN iad Be es oe Foe Se te et Tae ds lan alow eS i OOS FB ae 
sa ee CaN ad 





Here is an example of how you specify the DUMP.command to perform a:logical . "+" 
PRESSES | volume e dump: - | 


DUMP DATASET(INCLUDE(**)) - 


LOGINDDNAME(DASD1) - | 
seor SOUTODNAME (TAPE) ontesia:. nea 1808 ono ER 





anya 
: ay v 
Pree ee 





Note: Certain data sets can be restored only to like devices even though they were 
dumped logically. 


Physical Volume DUMP 
To perform a physical volume dump, specify the DUMP ‘commana with 
INDDNAME or INDYNAM and OUTDDNAME. Because FULL is the default 
for DUMP, you need not specify it. Unallocated tracks are not dumped. The 
following example shows how you can specify the DUMP command to physically 
pack ane a volume: issih bed. celgpactat hay abies Keane ass 
— ee sng Se tythe ES 1S RE ES TS TE SR ae 
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DUMP INDDNAME(DASD1) OUTDDNAME (TAPE) 


If you plan to use stand-alone DFDSS restore to restore a volume (with no~ 
“operating system), the volume must be dumped physically. In addition, when ioe 
a full physical volume dump to back up a system residence volume, you must use 
JCL to invoke DFDSS. 


Efficiency Considerations for Dumping Data 


When backing up data, you can specify both the OPTIMIZE and COMPRESS 
keywords to improve performance and save dump space. The two keywords can be 
used together; they are no longer mutually exclusive. 


Doing a selective data set DUMP saves space, but performance is slower than a full 
volume DUMP. The same applies to the COMPRESS parameter. It saves dump 
space, but involves some processing overhead. In general, if you are dumping to 
tape, saving space is probably less of a concern than performance. Space savings is 
usually important only when it results in using fewer tapes to store the data because 
that, in turn, reduces the number of tape mounts necessary to recover the data. 


| Space Considerations 
| Using larger block sizes saves dump space and improves performance by minimizing 
the number of I/O operations performed during a DUMP operation. 


Note: If you have a 3480 tape drive with the Improved Data Recording Capability 

| (IDRC) and you want to use hardware data compaction, you do not need to use the - 
COMPRESS keyword with the DUMP command. If you want software 

| compression, specify the COMPRESS keyword, but do not specify 

| DCB=TRTCH =COMP in the JCL. 





The default block size for output records written to tape is 65 520 bytes (65 520 is 
also a maximum). You can change this default to 32 760 bytes by turning on the 
UFOBK32K bit in the ADRUFO macro when the installation exit is called. For 
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output records written to DASD, the. block size is the track length of the output 
volume for devices whose track length is less than 32K bytes, or one half the track 
length for devices whose track length is greater than 32K bytes. You can select a © 
different block size by coding DCB= BLKSIZE= block size in the corresponding DD 
| statement. The minimum block size you can select is 7892 bytes; the maximum is 
32760 bytes. | 
: | .Note: ‘To have thé block size spébitieation included in the tape label, you must’) )0.-u~ 
specify the BLKSIZE parameter in the DD statement for the tape. 
You can also save dump space by doing the following: 
¢ Dump only the used space (the default), instead of all allocated space, in SAM 
and PAM data sets or in data sets with a null DSORG field. 
° Use the COMPRESS parameter. . 
¢ Perform incremental data set backup instead of volume backup. This reduces 
the amount of data dumped and decreases processing time. 
Performance Considerations © neg Ghee. tdi WEEE ee Re OE Es ae eres 


You can improve seepsran ase by doi the following: 


* Dump to tape, where the larger block size reduces the number of I/O operations. 


Use OPTIMIZE(2), (3), or (4) to read a number of tracks per read operation, 


equal to two tracks, five tracks, or a full cylinder, respectively. The default, 
OPTIMIZE(1), reads one track at a time. OPTIMIZE(2), (3), or (4) results in 
less elapsed time and fewer EXCPs on the DASD device, provided: 


— The names of track overflow data sets not flagged as such in the VTOC’s 
Format 1 DSCB are specified with the TRACKOVERFLOW keyword and 


— The load on the tape channel is low enough and the tape speed high enough 
to keep pace with the data being read from the DASD volume. 


Shared DASD Considerations 


Shared DASD presents volume and data set serialization problems not encountered 
in nonshared DASD environments. Care should be taken when you do data set 
operations if programs operating in another processor might be accessing the data 
sets at the same time. 


A data set can be dumped from one processor while being processed from another. 
The dumped version may be partially updated on JES2 systems. This is the same 
exposure that is present on a full DUMP. 


Restoring Data Sets 


With the RESTORE command, you can.restore data to DASD volumes from 
DFDSS-produced dump volumes. The dump volume to be restored is identified 
with the INDDNAME keyword. 


The RESTORE is logical or physical depending upon the dump tape. If the dump 
tape was made physically, a physical RESTORE is done. If it was made logically, a 
logical RESTORE is done. If the data was compressed when it was dumped, it is 
automatically expanded to its original form during the RESTORE operation. 
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Logical Data Set Restore 
A logical data set RESTORE is done if you are restoring from a logical dump tape 
(a tape created with logical DUMP) and you specify the DATASET keyword. For 
instance, the following RESTORE command generates a logical data set RESTOR’ 
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RESTORE INDDNAME(TAPE)  - 


_ DATASET(INCLUDE(USER1.OLDDS)) - 
REPLACE 





DFDSS logical RESTORE processing cannot be used to process PAM data sets 
containing location-dependent information that does not reside in note lists or the 
directory. As an example, PDS load libraries that contain overlay modules are not 
supported during logical RESTORE processing. 


You can restore to unlike devices with logical RESTORE. 


Output Volume Selection 
In most cases, specifying output volumes is optional for logical data set RESTORE. 
Output volume specification is required only if the data set: 


e Exists and is to be restored to a volume that is different from the current 
location or 


¢ Does not exist and is to be restored to a volume that is different from the source 
volume. 


Specify output volumes with the OUTDDNAME or OUTDYNAM keywords. An 
example of a logical data set RESTORE with OUTDDNAME is: 


RESTORE - 


INDDNAME(TAPE) OUTDDNAME(DASD1) - 
DATASET (INCLUDE (**) ) 





When not specified, the volume on which the data set currently resides is found from 
the catalog and dynamically allocated. This ts particularly useful on a data set 
RESTORE from a data-set-selection-by-catalog dump because you need not know 
where the data sets resided at dump time. 
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You can specify multiple output DASD volumes on a logical data set RESTORE. -_ 
- This is required when all the data sets to be“restored cannot fit on a single Volume. 
- An example of a logical data set RESTORE with a spill volume specified is: 







RESTORE - 
oo[e > 2nd INDDNAME (TAPE) OUTDYNAM( (338001) , (338002) . Toe eT ee 

HP" “DATASET (INCLUDE (PARTS 8) )>* = ct HEME Sa 
PCTU(80) 







Note the use of PERCENTUTILIZED (PCTU) in the above example. With 
PERCENTUTILIZED, you can set a limit on the amount of space DFDSS can fill 
on the volume. When this limit is reached, subsequent data sets are allocated to — 
other volumes. In the above example, PERCENTUTILIZED is used to specify that 
only 80% of the first target volume be filled. This leaves 20% free space for the 
data sets to extend, if necessary. 


” PERCENTUTILIZED 1 is ignored for SMS. volumes, 


Note: User data- set labels on DASD volumes are ipso Sanne: a ee set — 
RESTORE operation. However, either the data set on both the source and target 
volume must. have these labels or eatuad must ane ene 


Restoring to Preallocated Target Data Sets 
. In some instances, you might want to control the placement of a data set on a 
volume when you restore it. Some data sets (such as data sets allocated by absolute 
track) have location-dependent data and must be preallocated. Others (such as 
catalogs) should be placed fcr performance reasons. For details on restoring such 
data sets, see “Restoring ISAM, Unmovable, DAM. and Absolute Track Data Sets” 
on page 61 and “Restoring Integrated Catalog Facility Catalogs” on page 60. 


If a target data set is preallocated on either a like or unlike device, it is scratched 
and reallocated if it is not large enough to contain the dumped data set. VSAM 
preallocated target data sets are also scratched and reallocated when: 


e Any of the following source and target data set attributes do not match: 


— CI size 

— Record length 

— IMBED (KSDS and key range data sets only) 

— Key length (KSDS and key range data sets only) 

—- REPLICATE (KSDS and key range data sets only) 
— SPANNED. 


¢ The preallocated target is multivolume and the space of the target data set on 
the first volume is not large enough to contain all of the dumped data. 


* The data set was not defined as reusable and the high-used relative byte address 
(RBA) of a target VSAM KSDS 3s not 0. 


In logical restore, partitioned data sets are restored to both like and unlike devices in 
a compressed format. If the partitioned data set is being restored to an unlike 
device, the device-dependent information (such as TTR pointers and note lists) are in 
an usable form after the restore. DFDSS is unable to resolve device-dependent 
information for all other data set types being restored to unlike devices. 
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The NOPACKING keyword i is effective only for partitioned data sets. If-. 


“= NOPACKING is specified for preallocated partitioned data sets, the preallogs ed: 
... target must reside on a same or like device. ‘Processing is stopped for the data set if 


_ the target tesides on an unlike device. The target is not deleted and reallocated. 


Cataloging Data Sets During Logical RESTORE 


Rtg, by 
peri 
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“search or recatalog ivimits: origitial catalogs” ‘The CATALOG’ keyword Catalogs the 


When you restore a gata a. set, >¥ou.m might need to. catalog it.in the standard order of. 


data set in the standard order of search, The RECATALOG(*) keyword catalogs it 
in the same catalog that points to the source data set. 


When a data set is restored as an SMS data set, it is cataloged using the standard 
order of search. The RECATALOG keyword is dene: 

Examples of the CATALOG ‘and RECATALOG eee fe ina iegical as set 
RESTORE follow. 


_ RESTORE , _esnagn esse owns geno bc ange nate 
"INDDNAME (TAPE) 


DATASET ( INCLUDE (USER1. ae) ) 
CATALOG 





Po 


| RESTORE | | 
: INDDNAME (TAPE) 


DATASET (INCLUDE (USER1..**)) = | 
| RECATALOG(*) | 
Ue ee ee oe ee ee ere se eh oe Ee et te wt et a Bd Ad 


When a VSAM KSDS or key range data set is being restored to an unlike device. 
the data set must be cataloged in the standard order of search. You should also 
note thata VSAM KSDS or key range data set that has had CA splits and is being 
restored to an unlike device, will take significantly longer to restore. 


Renaming Data Sets During Logical RESTORE 

In addition to cataloging data sets when they are restored, you can also rename 
restored data sets by using the RENAME keyword. For instance, you can code the 
following to rename a data set you are restoring: 












| RESTORE. - 

INDDNAME(TAPE)  - 
DATASET (INCLUDE(USER2.0LDDS)) - 
RENAME (*.OLDDS,*.NEWDS) 


Note: RENAME will work only if the data set exists on the output DASD with the 
old name. If you really want to unconditionally rename a data set, uue RENAMEU. 
Both VSAM and non-VSAM data sets can be renamed. The rules for renaming 
VSAM clusters are the same as for non-VSAM data sets. You can only rename 
clusters. DFDSS assigns a new name for the components of VSAM clusters. If the 
old component names were assigned by the system, the new component names are 
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assigned by using a similar mechanism: If the component riames wete assigned by * 
using the cluster name (such as clustername.data or clustername.index), the new. 
component names are similarly assigned. 


renamed, you must have read access to the source data set as well as update access 


to the target data set. 


If a profile no longer exists for non-VSAM data sets that 


were protected under a discrete profile at DUMP time, you will need to predefine a 
new discrete profile or preallocate the data set with a discrete profile. These 
conditions do not apply if authorization checking is bypassed in any way. 


DFDSS tries to define renamed data sets to RACF during a data set RESTORE if 
they were RACF-protected during the DUMP. If the high-level qualifier of the data 
set is replaced with the user-supplied RENAME parameter, this new group of 
first-level qualifiers of newname must have been defined to RACF. If you restore a 
RACF- “protected data set to a volume other than the one from which the dump w was 


“taken and do not use the RENAME paraméter, the restored data’set bécomes ao“ 8 


duplicate-named data set. DFDSS does not create password entries for muaeed 
password-protected data sets. 


The following table shows how DFDSS treats RACF-protected data sets for a 
logical RESTORE when the user has sufficient data set access authority. 


No RENAME— 
Preallocated 


No profile to 
define. 


If already 
generically or 
discretely 
protected, no 


profile to define: 


else, define a 
discrete profile. 


If already 
discretely 
protected, no 


protile to define; 


else. define a 
discrete profile. 


No RENAME— 
DFDSS-allocated 


No profile to 
define. 


If already 
generically 
protected, no 
profile to define; 
else, define a 
discrete profile. 


Define a discrete 
profile. 


RENAME— 
Preallocated 


No profile to 
define. 


If already 
generically or | 
discretely 
protected, no 


profile to define; 


else, define a 
discrete profile. 


If already 
discretely 
protected, no 


profile to define: 


else, define a 
discrete profile. 


Figure 25. RACF-Protected Data Sets in a Logical Data Set RESTORE 


Notes to Figure 25: 


RENAME— 
DFDSS-allocated 


No profile to 
define. 


If already 
generically 
protected, no 
profile to define; 
else, define a 
discrete profile. 


Define a discrete 
profile. 


e Data sets protected by both generic and discrete profiles at DUMP time are 
considered to be discretely protected. 


e If MENTITY is not specified when DFDSS defines discrete profiles, default 
discrete profiles are defined. The default discrete profiles give ALTER authority 
to the user ID specified on the JOB statement. 
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Physical Data Set Restore “O° 


A physical data set RESTORE is done if you are restoring from a tape created by 
physical DUMP and you specify the DATASET keyword. If the dump volumes . 
resulted from a physical data set DUMP operation, you must do a physical data set 
RESTORE or a tracks RESTORE. A tracks RESTORE can consist of a ae of 





zz the dump , data, oe ser eae ee ces 
Fo ented oF age Sb ots SG ae oe 
Notes: 


¢ When you perform a physical restore of many data sets, there is an initial delay 
while DFDSS allocates the target data sets. 


¢ To prevent index components from being restored sania you must 
specify the fully-qualified name of the cluster. ns 


On a physical data set RESTORE, data sets from one or more logical volumes can 
be restored to a single DASD volume. If you want to restore data sets from specific 
source DASD volumes, use the LOGICALVOLUME keyword to specify the volume 


ae 


js» , Serial numbers of the source DASD volumes you want to restore. For example: 0... 


RESTORE - | 
~ INDDNAME (TAPE) -OUTDDNAME (DASD1) = 


DATASET (INCLUDE (**) ) sea as - 
REPLACE ~ 





Note: Data from a specific volume can be restored only to a DASD volume of like 
device type. 


Output Volume Selection 


For physical data set RESTORE, you must specify an output volume with the 
OUTDDNAME or OUTDYNAM keyword. A physical data set RESTORE 
restores only the first volume in a list passed in the OUTDDNAME or 
OUTDYNAM parameter. Selection of target volumes in an SMS environment is 
considerably different. See “Restoring SMS-Managed Data Sets Physically” on 
page 67 for more details. 


Cataloging Data Sets During Physical RESTORE 


If you specify CATALOG on a physical data sett RESTORE, DFDSS creates catalog 
entries for single volume non-VSAM data sets that were allocated by DFDSS. The 
cataloging is done immediately after successful allocation of a data set. Failure in 
cataloging, however, does not prevent the data set from being restored. Any data set 
that was allocated and cataloged but encounters errors during the RESTORE 
Operation is neither uncataloged nor scratched by DFDSS. You must not specify 
the RECATALOG keyword for physical RESTORE. 


The catalog that DFDSS uses to catalog a data set is determined as follows: 


¢ The catalog specified by a STEPCAT or JOBCAT (but not both) DD statement. 


¢ Ifthe STEPCAT or JOBCAT DD statement specifies concatenated catalogs, 
only the first catalog in the concatenation is used. 
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e Ifno STEPCAT or JOBCAT DD statement is provided and.the first qualifier of 
the data set name is an alias for a user catalog or r for a cv OL, the catalog: 
pointed to is used for that data set. 


¢ Otherwise, the master catalog is used. 


___., ..You should use the IDCAMS DEFINE RECATALOG command to eee YSaM 
“eon “data sets that were allocated by DFDSS (not preallocated).7:. 2 88 fore mes 


Physical RESTORE of RACF-Protected Data Sets 

For physical data set RESTORE of RACF-protected data sets, you must have 
update access to the target data set. To rename non-VSAM data sets during 
RESTORE, you must have read access to the source data set and update access to 

, the target data set. If a non-VSAM data set was protected under a discrete profile 
and the profile no longer exists, a new discrete profile must be defined before the» 
RESTORE, or the data set must be preallocated with a discrete profile. These 
conditions do not apply if authorization checking is bypassed in any way. 


The protection status of data sets that are testorsd ae vey of phyace! ee set 
RESTORE is unpredictable if: Tae gee ee ae Se 


¢ RACF profiles (generic or discrete) of the data sets have been changed between 
DUMP and RESTORE 

* The dump was produced on a system (that supports RACF generic profiles) 
other than the one used for the restore. 


Restoring Data Sets with Special Requirements 


Some data sets have special requirements for being restored. The sections that 
follow describe some of the special cases you might encounter when you restore data 
sets. 


Restoring Multivolume Data Sets 
Multivolume data sets from a logical data set dump tape can be restored either to a 
single volume or to multiple volumes. When they are not preallocated and the 
specified output volumes are different from the input volumes, multivolume data sets 
are restored to a single volume, space permitting. When multiple target volumes are 
specified, DFDSS selects target volumes as follows: 


¢ Ifa target volume that has the same volume serial as the source volume is 
available and has adequate space, it is chosen. 


¢« Ifa volume of the same device type is available, and if it has adequate space, it 
is selected. 


e A volume of a like device type is selected if it has adequate space. 

¢ A volume of an unlike device type is selected if it has adequate space. 
Note: To catalog multivolume non-VSAM data sets, use IEHPROGM. 
If you are restoring a multivolume data set from a physical dump, be sure the 
segments from all volumes are restored with successive RESTORE commands. 
Restoring a portion of a multivolume non-VSAM data set is allowed only if the 


volume sequence numbers of the source and target volumes are the same. A 
preallocated data set is required on the target volume. 
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Restoring integrated Catalog Facility Catalogs’ YE" 
Integrated catalog facility user catalogs can ee festoned “ to the same volumes 
from which they were dumped. The component names of the source and target user _ 
catalog must be the same. ‘In addition, you must specify the fully-qualified name to 
restore a Serres 


a Ee, 


user ee aliases if aa are present in vibe local dump data set. For logical 
RESTORE, user catalog aliases are restored as follows: 


e If DFDSS allocated the user catalog, aliases are restored if the catalog is 
successfully restored. 


Ifthe target catalog was preallocated and is not empty, aliases are not restored. 


e If the target catalog was preallocated and empty, aliases are restored. 


Physical RESTORE does not restore aliases, and physically dumped catalogs cannot 
be restored if they are open. In addition, if the entries in the catalog during DUMP 
do not match the. entries during the physical RESTORE, some of the data sets may » 
become inaccessible. gen 


With MVS/XA DFP Version 2 Release 3 or later release, an integrated catalog 

_ facility user catalog can be restored dynamically. Catalog recovery jobs should be 
modified to include the IDCAMS ALTER LOCK command to lock the existing 
catalog before the DFDSS RESTORE. After the recovery is complete, unlock the 
catalog using IDCAMS ALTER UNLOCK. The LOCK attribute on the dump tape 
is used if the catalog does not exist. For information on the LOCK attribute and 
the access authority, see Catalog Administration Guide. 


The following example shows the JCL used to restore an integrated catalog facility 
user catalog. The master password of the master catalog is required. Passwords are 
not required if you have DASDVOL update access or if the installation 
authorization exit bypasses authorization checking. 


//SYSPRINT DD SYSOUT=A 

//TAPE DD _—_— UNIT=3480, VOL=SER=TAPEO1, 

// LABEL=(,NL), DISP=(OLD,KEEP) ,DSNAME=USER2. BACKUP 

//DASD DD —_-UNIT=3380,VOL=SER=338001,DISP=OLD 

//SYSIN. DD * 

RESTORE OUTDD(DASD) INDD(TAPE) - 

DS(INCL(TEST.CAT.USERCAT)) REPLACE - 
PSWD(TEST. CAT. USERCAT/USERMPW1) 


Ve 





Figure 26 on page 61 shows the printed output produced by the RESTORE. 


Note: Data set passwords are suppressed and do not appear in the printed output. 
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PAGE 0001 DFDSS 5665-327 DATA FACILITY DATA SET SERVICES V2R5.0 89.046 10:36 


RESTORE OUTDD(DASD) INDD(TAPE) - 
DS(INCL(TEST.CAT.USERCAT)) REPLACE - 


PSWD(TEST.CAT.USERCAT/) 


ADR1OLI 
ADR1O9I 
ADROOGI 


ADR3961 
ADR4891 


ADR3931 
ADR3931 
ADR3931 
ADR3931 
ADR3931 
ADR393i 
ADR3931 
ADR3931 
ADR3931 
ADR3931 
ADRO131 
ADRO121 


RIQL (O1), TASKID O01 HAS BEEN ASSIGNED TO COMMAND 'RESTCRE ' 


RIQ1 (01 
(001) -SETUP(01 


(G01) -TDLOG (02 


(001) -TDNVS (01 
(901) -TONVS (01 
(001) -TONVS (01 
(001) -TONVS (01 
(001) -TDNVS (01 
(001) -TDNVS (61 
(001) -TDNVS (01 
(001) -TONVS (01 
(001) -TDNVS (01 
(001) -TDNVS (01 
(001) -CLTSK(O1 

DSSU (01 


), 


), 
ADR7801 (001)-TDDS (01), 
Pe aaa ay 


) 
) 
) 
) 
) 
) 


) 
) 
) 
) 
) 
) 


, 
> 
’ 
’ 
Ld 
’ 
2 
> 
? 
> 
> 
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88014 10:36:34 INITIAL SCAN OF USER CONTROL STATEMENTS COMPLETED. 

88014 10:36:36 EXECUTION BEGINS 

THE INPUT DUMP DATA SET BEING PROCESSED IS IN LOGICAL DATA SET FORMAT 

DATA SET TEST.CAT.USERCAT ALLOCATED, IN CATALOG ICFMAST1, ON VOLUME(S): 080026 
CLUSTER TEST.CAT.USERCAT WAS RESTORED 


CATALOG ICFMAST1 
COMPONENT TEST.CAT .USERCAT 
COMPONENT CATINDEX .T71FCDB4.V1D88014. T9DEBBBO 


ALIAS USER] RESTORED FOR USER CATALOG TEST.CAT.USERCAT 
ALIAS USER2 RESTORED FOR USER CATALOG TEST.CAT.USERCAT 
ALIAS USER3 RESTORED FOR USER CATALOG TEST.CAT.USERCAT 
ALIAS USER4 RESTORED FOR USER CATALOG TEST.CAT.USERCAT 
ALIAS USERS RESTORED FOR USER CATALOG TEST.CAT.USERCAT 
ALIAS USER6 RESTORED FOR USER CATALOG TEST.CAT.USERCAT 
ALIAS USER7 RESTORED FOR USER CATALOG TEST.CAT.USERCAT 
ALIAS USER8 RESTORED FOR USER CATALOG TEST.CAT.USERCAT 
ALIAS USER9 RESTORED FOR USER CATALOG TEST.CAT.USERCAT 
ALIAS USERO RESTORED FOR USER CATALOG TEST.CAT.USERCAT 
88014 10:37:13 TASK COMPLETED WITH RETURN CODE 0000 
88014 10:37:15 DFDSS PROCESSING COMPLETE. HIGHEST RETURN CODE IS 9000 


Figure 26. Output from Restored Integrated Catalog Facility User Catalog 


Restoring ISAM, Unmovable, DAM, and Absolute Track Data Sets 


One important use of DFDSS is restoring data sets that contain device-dependent 
information. In some cases, such data sets can be restored without preallocating the 
target data sets. In other cases, however, you must preallocate the target in order to 
restore the data set. 


Restoring without Preallocated Targets: If you have MYS/XA DFP Version 2 
Release | (or any later release), you can use logical data set RESTORE to restore an 
ISAM data set without preallocating it if the tracks on which it is to be restored are 
not occupied and the volume has an indexed VTOC. If an ISAM or unmovable 
cata set is not preallocated and the system is running in the MVS-XA DFP Version 
2 Release | environment, DADSM is called to allocate the data set. If DADSM 
tails or if the system does not run in the MVS XA DFP Version 2 Release 1 
environment. the data sets are allocated to any available location if FORCE is 
specified. 


When you specify FORCE and some of the data sets have truly location-dependent 
data. vou should prevent DFDSS from restoring them by specifying their names in 
tne EXCLUDE parameter. Subsequently, you must either free up the area of the 
DASD where these data sets were located on the source volume and rerun the 
RESTORE operation or restore the data set onto a scratch volume. 


IP you do not have MVS/XA DFP Version 2 Release | (or later release), you can 
“estore an u nmovable or an ISAM data set without preallocating it by doing the 
following: 


i. Restore track 0 and the VTOC from the dump tape to a scratch volume. 


2. Restore the desired unmovable data set to the scratch volume from the dump 
tape. . 


Either scratch all unwanted data sets from the scratch volume and use the 
unmovable data set that is left. or use an appropriate utility such as IEBISAM, 
IEBCOPY. or IEHMOVE to move this data set to the desired volume. 


Loe) 
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Restoring to Preailocated Targets: If you are restoring any of these types of data 
sets by preallocating them, the size and location of the extents on the dump volume 
and on the restore volume should match. 


For unmovable data sets (those allocated as ABSTR, PSU, POU, or DAU), a 
preallocated data set is restored if the extents match and REPLACE is specified. 
Even if the extents do not match, the data set is restored if you specify both 
REPLACE and FORCE. When an unmovable data set cannot be restored, the 
extents of the data set on the source volume are listed so that you can take action to 
restore It. 


Note: ISAM data sets and CVOL data sets cannot be restored to unlike devices. 


Restoring DAM Data Sets: When DFDSS restores Direct Access Method (DAM) 
data sets, the following apply: 


e If the receiving volume track capacity is equal to or greater than the source 
volume track capacity, the DAM data set is allocated on the receiving volume 
with the same allocation as the source contained. The restore yields an usable 
data set; however, some unused space might remain on each track of the target 
data set. 


¢ If the receiving volume track capacity is smaller than the source, FORCE must 
_be specified. This forces the DAM data set to be restored on any available 
space by track packing. DFDSS updates the relative byte address (RBA) 
information contained in fixed-length data sets so these will still be usable after 
the restore; variable- and undefined-length TTR-organized BDAM data sets 
might be unusable. 


Restoring an Undefined DSORG Data Set 
The PROCESS(UNDEFINEDSORG) keyword permits logical data set RESTORE 
of an undefined DSORG data set to an unlike device of larger track capacity. The 
restore yields an usable data set; however, some unused space might remain on each 
track of the target data set. 


Restoring a VSAM Sphere 
With DFDSS Version 2 Release 4, you can restore an entire VSAM sphere (base 
cluster and all associated alternate index clusters and paths). The SPHERE keyword 
causes DFDSS to restore the entire VSAM sphere. Provided the dump was also 
taken with the SPHERE keyword specified, all you need to specify is the base cluster 
name to restore the base cluster and the other components. 


When you restore a SPHERE to a preallocated target, all components (base clusters, 
alternate indexes. and paths) of the sphere must be preallocated. DFDSS does not 


restore a sphere if only some parts of the sphere are preallocated. 


An example of the RESTORE command with the SPHERE keyword is: 


| INDDNAME(TAPE) - 

| DATASET (INCLUDE(PARTS.VSAM1))  - 
| SPHERE - 

| REPLACE - 

PSWD (PARTS. VSAM1/MASTUPW1) 
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Pa ee | 


“Restrictions for RESTORE” on page 115 lists considerations for restoring VSAM 
spheres. 


Restoring a VSAM Cluster: Restoring a VSAM cluster is allowed if the following 
are the same on the source and destination volumes: 


The number of components on the volume 
The beginning relative byte address (RBA) 
The component names 

Catalog names. 


If a cluster is preallocated, its size must be equal to or greater than that on the 
source volume. (Only the tracks that were dumped are restored.) 


If you preallocate a VSAM data set before restoring the data set via DFDSS, you 
should ensure that the control interval size, allocation unit, and secondary allocation 
quantity are the same as in the initial definition. 


Note: VSAM data sets residing on DFDSS data set dump tapes created in an 
MVS/XA DFP Version 2 Release 2 (or later release) environment cannot be restored 
in an MVS/XA DFP Version 2 Release | or an MVS/370 DFP Version }! 
environment without certain VSAM N*512 toleration PTFs. 


Restoring the VVDS and the VTOCIX 
To restore a VVDS or VTOCIX data set, you must specify the fully-qualified data 
set name. The VVDS and the VTOCIX data set cannot be restored with other data 
sets in the same RESTORE command. VVDS and VTOCIX data sets should not be 
restored by data set as a normal recovery procedure. The VTOCIX data set is an 
extension of the VTOC and can be rebuilt using IBM’s Device Suppori Facilities 
program (ICK DSF). 


The VVDS is an extension of the VTOC and of the catalogs for the VSAM data sets 
On the volume. [fit is restored by a data set RESTORE, it is possible that some of 
these data sets can become unusable because of a mismatch between the catalog, 
VVDS. and the VTOC. If this occurs. run the diagnose function of Access Method 
Services to determine the extent of the proolem and take appropriate corrective 
action. 


Restoring a PDSE 
With DFDSS Version 2 Release 5 it is possible to restore a PDSE. The PDSE 
cumnot be restored by using releases prior to DF DSS Version 2 Release 5, nor can 
they be restored on a system using releases prior to MVS:/DFP Version 3 Release 2 
and MVS SP Version 3 Release 1.0E. The target volume must be SMS-managed. 


Restoring a Damaged PDS 
A PDS ts monitored by DFDSS during track packing for conditions that are not 
normal. The following conditions are detected and reported: 


e Missing high key entry in the PDS directory. 
* Missing directory EOF. 
* Invalid member start TTR 


— TTR points before directory EOF 
— TTR points after end of data set. 
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¢ Missing member EOF. (Each member of a partitioned data set is normally 
terminated by an EOF record.) 


e Invalid note or notelist TTR. 


— Note pointing before the start of member data 

— Note pointing after the member EOF 

— Note pointing past the last valid record on a track 
~— Note pointing to record 0 of a track. 


All of these conditions are noted by DFDSS with a message. 


During track packing, DFDSS repairs missing high key directory entry, missing 
directory EOF, and missing member EOFs. 


Invalid start TTRs prevent DFDSS from track packing data for that member. 
DFDSS translates all valid note and notelist TTRs during track packing. 


Damaged partitioned data sets can be restored to same or like device target volumes 
by using the NOPACKING keyword. .This results in an exact track-for-track mage 
of the source data set. Obviously, no compression is performed in this case. 


Restoring Data Sets in an SMS Environment 
Use the RESTORE command to recover data sets in an SMS environment. If the 
data set was dumped logically, it is recovered logically. If it was dumped physically, 
it is recovered physically. 


As discussed earlier. an SMS environment can contain both SMS-managed and 
non-SMS-managed data. The following sections discuss how you can use the 
RESTORE command to recover these data sets. 


Restoring SMS-Managed Data Sets 
Wren you use the RESTORE command in an SMS environment. Automatic Class 
Selection (ACS) routines are invoked. 


When you use RESTORE, you are in the ACS RECOVER environment 
(K&ACSENVIR='RECOVER'). The storage class ACS routine is executed first. If 
the storage class assigned is not null, the management class ACS routine and then 
the storage group ACS routine are executed. (See “ACS Variables Available during 
RESTORE and CONVERTV”™ on page 110 for a list of variables available to ACS 
routines during RESTORE processing.) 


DFDSS passes a data set’s classes to ACS as input. and the ACS routines can assign 
or override these input classes. 


If the source data set is non-SMS managed and has no class names. DFDSS passes 
null classes to ACS. If the source data set is SMS managed and vou do not specify 
otherwise, DFDSS passes ACS the source data set’s classes. If you specify what you 
want passed to ACS with the STORCLAS, MGMTCLAS, NULLSTORCLAS. or 
NULLMGMTCLAS keywords, DFDSS passes ACS what you specify. In all cases, 
the ACS routines ultimately decide the classes assigned to the data set. 


You can, however, force the storage and/or management class you specify to be 


assigned to a data set by using the BYPASSACS keyword with the RESTORE 
command. 
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The following RESTORE command results in ACS routines determining the target 
classes, using the source classes as input: 


| 
| RESTORE - 
INDDNAME(TAPE) - 


DATASET (INCLUDE (USER12.**) ) 





For details about using RESTORE io convert data to and from SMS management, 
see Chapter 9, “Converting Data to and from SMS Management” on page 91. 


Changing Storage Class with RESTORE 


In some cases, you might want to pass ACS a storage class that is different from 
that of the source data set. You can specify RESTORE with STORCLAS to pass 
ACS a storage class name as follows: 





| 
| RESTORE - 
| INDDNAME(TAPE)  - 
DATASET (INCLUDE (USERIZ.**)} - | 
STORCLAS(SCNAMEL)  - a 
| REPLACE 


However. using STORCLAS does not guarantee that the data set is assigned the 


storage class vou specify. It means only that the storage class you specified is passed 
ro rhe ACS routes: Depending on pow tne AGS routines are written. The storage 


class Vou specify can be ignored. assigned to the data set. or used in combination 
with other input variables to determine a new storage class for the data set. 


NER aig gina: 


Lae Se 
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dataset with the a St TORC LAS. Enst 





igned to the data set. you 
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To make certain that the storage class vou specify is a 
can use BYPASSACS as follows: 


CG) OC) wa 








In this case. aoe is not invoked. and theretore the data set is assigned whatever you 
have spec hed with STORCLAS or. if vou do not use Oe the source data 

set's storage ease: Howeser. when vou use BYPASSACS. vou should make certain 

that the storage class vou specify is valid. [f you use BYPASSACS and assign an 


fin 
invalid storage class. vou Zot an error. 


= 
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To limit the use of BYPASSACS, you need to set up a RACF facility class profile. 


You can use the NULLSTORCLAS keyword in conjunction with BYPASSACS to 
make a data set non-SMS managed. For example, the following specification of 
RESTORE causes the specified data sets not to be SMS managed: 


RESTORE - 


INDDNAME(TAPE)  - 

DATASET (INCLUDE(USER12.**))  - 
NULLSTORCLAS - 

BY PASSACS (**) 





Changing Management Class with RESTORE 
In addition to influencing a data set’s storage class when you restore it, you can also 
give ACS input for assigning or overriding the data set’s management class. By 
specifying MGMTCLAS, you can pass a management class name to ACS and, as 
with STORCLAS, ACS may ignore it, assign it to the data set, or use it in 
combination with other input variables to determine the data set’s management class. 
By specifving NULLMGMTCLAS, you can pass a null management class to ACS, 
which may or may not assign a management class. 


An example of RESTORE with the MGMTCLAS keyword Is: 





: INSDNAME(TAPE) - 

| DATASET (INCLUDE(USER12.**))  - 
| MGM™CLAS(MCNAME1) — - 

| REOUACE | 





Like STORCLAS, RACF checks if the RESOWNER of a given data set is 
authorized to define the data set with the given MGMTCLAS. Ensure that the 
RESOWNER of the data set has the proper authority to use the indicated 
management ciass. 


Also just as vou can with STORCLAS. vou can use MGMTCLAS with 
BYPASSACS to make certain that the data set is assigned the management class you 
specify. For instance: 


| INDONAME(TAPE) - 
DATASET(INCLUDE(USER12.**)) = 
| MGMTCLAS(MCNAME1) = - 
BYPASSACS(**) = 

| REPLACE 








If vou use BY PASSACS with MGMTCLAS, you should be certain that you are 
assigning a valid management class to the data set. If the management class is not 
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valid, the data set is not restored. Remember that BYPASSACS skips both the 
STORCLAS and MGMTCLAS ACS routines. 


To limit the use of BYPASSACS, you need to set up a RACF facility class profile. 


When you influence or assign the management class of a data set, you also need to 
be careful that the data set resides in a storage group capable of providing for the 
management class attributes associated with the management class you specify. For 
instance. if a data set has a management class that makes it eligible for migration, it 
needs to reside in a storage group on which DFHSM does migration. Otherwise, the 
data set will never migrate. For this reason, you might have to change the storage 
class along with the management class to ensure the data set resides on volumes that 
can accommodate its management class. 


Restoring SMS-Managed Data Sets Physically 
In general. it is recommended that you use logical data set RESTORE in a SMS 
environment. If you use physical data set RESTORE, you should be aware of the 
special rules for volume and construct selection. 


When restoring a non-SMS user catalog on an SMS-managed volume or an 
SMS-managed user catalog on a non-SMS volume. physical restore does not convert 
the catalog. Instead, DFDSS physical restore ensures that the user catalog looks 
exactly like the source catalog (SMS or non-SMS) and then piaces the output 
volume in INITIAL status. 


DFDSS physical RESTORE is sensitive to the number of logical volumes in a dump 
data set. A DFDSS physical dump tape can contain multiple logical volumes. 
Because 2 physical dump operates at the track-image level, every volume from which 
data was dumped is on the tape in the form of a logical volume. The following 
exampie shows how a dump tape can contain more than one logical volume: 





DUMP - 
DATASET(INCLUDE(**)) = 

| 7NDYNAM( (338001) , (338002))  - 

2 CUTDD(TAPE) - : 
| COMPRESS | | 
I po 


If data sets are dumped from both volumes. two logical volumes are on the dump 
tape. 
During povsical RESTORE. the process is as follows for each logical volume: 


e Determine the SMS constructs of each data set to be restored trom that logical 


nyly 
Voilume., 


¢ Determine the target volume for the RESTORE. Ina physical RESTORE, you 
can nave only one target volume per logical volume. 
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The following process is used to select the target data set’s SMS constructs: 


1. Ifa data set is preallocated and REPLACE is specified, the constructs of the 
preallocated data set are used. 


2. For data sets that are preallocated and have RENAME or RENAMEU 
specified and data sets that are not preallocated: 


a. If BYPASSACS is specified for the data set, the constructs from the data set 


on the dump tape are used (unless overridden by STORCLAS, 
MGMTCLAS, NULLSTORCLAS, and/or NULLMGMTCLAS). 


. If BYPASSACS is not specified for the data set, the ACS routines are 


invoked to determine the data set’s constructs. The constructs from the data 
set on the dump tape are passed to ACS as input (unless overridden by 
STORCLAS, MGMTCLAS, NULLSTORCLAS, and/or 
NULLMGMTCLAS). 


The following process is used to select a target volume. The process continues until 
a volume is selected. 


1. If any input data set is preallocated on the user-specified volume and REPLACE 


or RENAMEU is specified, the user-specified volume is the target volume for 
the entire logical volume. 


. If any input data set is non-VSAM and multivolume with a sequence number 


greater than one, the user-specified volume is the target volume for the entire 


logical volume. 


3. Repeat the following steps until a data set is successfully allocated. Once a data 
set is allocated, all other data sets from the logical volume are restored on the 
same volume: 


a. If the data set is to be SMS managed, call VTOC Data Set Services to select 


a volume to restore the entire logical volume to. 


. If the data set is to be non-SMS managed and the user-specified output 


volume is also not SMS managed, select the user-specified volume for the 
entire logical volume. 


. If the data set is non-SMS managed and the user-specified volume is SMS 


managed, continue with the next data set. 


Once a target volume is selected, all data sets from the logical volume are restored to 
it with the following exceptions: 


* Ifthe TGTGDS keyword is specified. the appropriate status 1s assigned to the 
data set. 


1 


* The requested target status does not violate rules of the generation data group. 


* The default status of logical and physical data set RESTORE 1s DEFERRED. 


Restoring GDG Data Sets 
For generation data group (GDG) data sets, filtering on generations is supported. 
Generation names in relative generation number. dsn(n), can be specified in the 
INCLUDE and EXCLUDE parameters. 
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Restoring SMS-Managed GDG Data Sets 


SMS-managed GDG data sets can be in any one of the following states: 


DEFERRED 
ACTIVE 
ROLLED-OFF. 


When restoring a GDG data set to SMS-managed storage, DFDSS does one of the 
following: 


¢ Preallocated RESTORE retains the status of the preallocated generation data set 
(GDS). 


e Physical data set RESTORE ensures that the non-VSAM volume records 
(NVRs) it builds for GDG data sets contain the correct status. 


¢ Logical RESTORE places the GDS in DEFERRED status, if the TGTGDS 
keyword is not specified. DFDSS leaves the GDS in DEFERRED status to 
enable you to (1) roll it back as an ACTIVE generation or (2) leave it as 
DEFERRED. 


Restoring Non-SMS-Managed Data Sets 
If you want to restore a data set to a non-SMS-managed target volume, you can use 
the NULLSTORCLAS and BYPASSACS keywords on the RESTORE command. 
If you use these keywords, the data set is placed on a non-SMS-managed volume, 
regardless of whether or not the source data set was SMS managed. 


Restoring Volumes 


You can recover a volume or ranges of tracks from a full-volume DUMP. If the 
dump volumes resulted from a full DUMP operation, you can do a full or a tracks 
RESTORE (that is. ranges of tracks) or a data set RESTORE. If the dump volumes 
resulted from a tracks DUMP operation (that is. ranges of tracks). you must do a 
tracks RESTORE. which can consist of a subset of the dump data. 


An example ofa full-volume RESTORE 1s: 


RESTORE - 


INDDNAME(TAPE)  - 
OUTDDNAME(DASD1) = 


{ 
{ 
i 


PURGE 


With the RESTORE operation, you can copy the volume serial number to the 
output DASD with the COPYVOLID keyword. For example: 








» RESTORE - 
INDDNAME(TAPE) - 
QUTDDNAME(DASD1)— - 
COPYVOLID. - 

PURGE 
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COPYVOLID is required if you are restoring an SMS volume, unless the source and 
target volume serial numbers match. 


You must consider several factors when restoring volumes in an SMS environment. 
Before you start to restore a full volume, you must ensure that the status of the 
target volume is synchronized with its environment. For example, if the target 
volume is a non-SMS volume, the volume must not be defined in a storage group. 
Conversely. if the target volume is an SMS volume, the volume must be defined in a 
storage group. Finally, if the target volume is SMS-managed, then SMS must be 
active for the full-volume restore operation. 


Output Volume Specification 
For a full or tracks RESTORE, you must specify an output volume by using the 
OUTDDNAME or OUTDYNAM keywords. 


The device type of the source volume used in the DUMP and the device type of the 
target volume used in the RESTORE must be the same. However, the following 
exceptions are possible: 


¢ Data from an IBM 3330 Model | can be restored to an IBM 3330 Model 11. 


¢ Data from an IBM 3340 with 35-megabyte capacity can be restored to an IBM 
3340 witn 70-megabyte capacity or to an IBM 3344. 


. Data from a smaller capacity IBM 3380 model can be restored to a larger 
capacity IBM 3380 model. 


* Data from a minivolume or a virtual volume can be restored to a real volume of 
like device type, and vice versa, device capacity permitting. 


* Data from an IBM 3330 Model 1! can be restored to an [BM 3330 Model 1, 
from a “J-megabyte 3340 to a 35-megabyte 3340, or from a larger capacitv IBM 
3380 model to a smaller capacity IBM 3380 model, provided the range of data 
to be processed falls within the capacity of the output device. 


Note: When you perform a full-volume restore toa DASD that is shared between 
multiple systems. the DASD should be offline to all systems except the one 
perrorming ine restore. 


When doing a full-volume restore to a larger-capacity DASD from a tape dumped 
from a smaller-capacity DASD with equivalent track lengths. you used to have to 
allocate a temporarv data set in order to correct the free space chain. With DFDSS 
Version 2 Release 3 and later releases. DFDSS updates the free-space DSCB and 
calls [CK DSF to rebuild indexed VTOCs. ICK DSF Release 8 and prior releases 
prompt the operator for permission to do this. 


As a result. vou might want to determine if the output volume is allocated before 
performing the full-volume restore. This can be done with the following operator 
command: 


| D U,DASD,ALLOC,cuu,1 


| 


a ee eee, 


This command displays a list of currently allocated volumes and the names of the 
jobs enqueued on them. 
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If CATALOG has enqueued on the output volume, you can take the following steps: 


1. Use the following catalog modify command to display a list of all open catalogs: 


MODIFY CATALOG, LIST 


2. Use the following catalog modify command to make CAS unallocate the 
catalog: 


F CATALOG, UNALLOCATE(catname) 


If there are no other allocated catalogs on the volume and the volume is not 
allocated by any other users, you can proceed with your full-volume restore. 










For more information on CAS allocation, see Catalog Administration Guide. 


Processing RACF-Protected Data Sets 


Recovering System 


On a physical RESTORE, DFDSS does not delete the profiles of RACF-protected 
data sets on the volume before a full RESTORE. After a full RESTORE, RACF 
profiles are not built for RACF-indicated data sets on the restored volume. If 
RACF data set profiles do not exist for these data sets, these data sets are 
inaccessible until RACF profiles are built for them. 


When you use the COPYVOLID keyword to change the volume serial number or if 
the volume serial for the dump volume and the restored volume are different, 
profiles are not built for the RACF-protected data sets on the restored volume or for 
the RACF DASDVOL for RACF-protected DASD volume. 


The protection status of data sets that are restored through a full RESTORE is 
unpredictable if: 


* RACF profiles (generic or discrete) of the data sets were changed between 
DUMP and RESTORE 


¢ The dump was produced on a system (that supports RACF generic profiles) 
other than the one used for the restore. 


Volumes 

You can use stand-alone DFDSS restore to perform either a full or a tracks restore 
from the first data set of DF DSS-produced dump tape(s). without the use of a host 
system environment. Using stand-alone DFDSS restore, you can recover system 
volumes in order to bring up the host environment. 


You can also use stand-alone DFDSS restore ina VM environment. Stand-alone 
DFDSS restore operates in Enterprise Systems Architecture (ESA)/370 mode, 
System/370 extended-architecture mode or System/370 mode. Refer to Data Facility 
Data Set Services: Reference for instructions on how to do the restore. 
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Chapter 8. Managing Data Movement with DFDSS 


Data movement is necessary when you are doing the following tasks: 


Replacing devices When you remove devices to be replaced with other ones, you 
must move the data off the devices you are removing. 


Adding devices If you add new devices at your site, you must move data onto 
them to take advantage of the added capacity. 


Maintaining devices When you are servicing a volume, you might need to move 
data off the volume so users can continue to access the data. 


Tuning performance _If a volume is performing poorly, it might be because a data 
set(s) on the volume is being frequently accessed and causing 
an I/O bottleneck. In this case, you might move that data 
set(s) to another volume(s) that is better able to handle it 
(either because it is less full or because it is cached). 


You can use the DFDSS COPY command to move data between volumes. 


This chapter is organized as follows: 


e “Preparing for Data Movement” discusses some things you should do prior to 
moving data. 


¢ “Moving Data Sets” on page 74 describes how to use DFDSS to move data sets. 


¢ “Moving to Preallocated Data Sets” on page 76 descnbes how to use DFDSS to 
move to preallocated target data sets. 


* “Defining RACF Profiles” on page 78 explains how profiles shouid be defined. 


¢« “Moving Data Sets with Special Requirements” on page 79 describes how to use 
DFDSS to move data sets with special requirements. 


“Moving Volumes” on page 84 describes how to use DFDSS to move volumes. 


¢ “Considerations for Moving Data Sets in an SMIS Environment” on page 86 
explains some of the special considerations for moving data sets in an SMS 
environment. 


« “Considerations for Moving Volumes in an S\IS Environment™ on page 89 
explains some of the special considerations for moving volumes in an SMS 
environment. 


Preparing for Data Movement 


In addition to the actual movement of data, you can do a number of things to 
effectively move vour data. 


Before moving vour data, you should determine the amount of space the data 
requires. You can determine this by building a data set or volume list with ISMF. 
A data set list indicates how much space is allocated for each data set and how 
much space it actually uses. A volume list indicates how much free space there is on 
each volume in the list. You can use this information to calculate how much space 
the data to be moved requires and to ensure that enough free space exists on the 
target volume(s). This calculation is especially important when combining multiple 
devices onto one larger capacity device. 
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Note: However, in an SMS environment, this calculation is unnecessary because the 
system finds the necessary free space and places the data for you. 


In addition to ensuring that enough free space exists to contain the data, you should 
back up the data before moving it to guard against its loss during the movement. 
You can use the DFDSS DUMP command to back up volumes or data sets. See 
Chapter 7, “Managing Availability with DFDSS” and Data Facility Data Set 
Services: Reference for more information on backing up data and the DUMP 
command. 


Evaluating the Use of Logical and Physical COPY 
As previously stated, you can use the COPY command to perform the actual data 
movement. However, you must determine whether to use logical or physical COPY 
to move the data. Physical COPY gives you better performance, but logical COPY 
allows you to move data to unlike devices. 


Because physical volume COPY enqueues on the volume, you should do it only at a 
time of low activity. Logical data set COPY enqueues at the data set level, and, as a 
result, it is less critical that you perform the COPY at a time of low activity. You. 
should, however, seriously consider doing so because DFDSS cannot move data sets 
that are in use. In addition, because logical processing takes more time than 
physical processing, you should do it at a time of low activity, especially if you are 
moving a large number of data sets. a . 


Note: It is best not to specify TOLERATE(ENQFAILURE) when moving data 
with COPY. Moving data while it is being updated can result in the loss of the 
updates. 


After DFDSS has finished processing, you can verify that the data has moved by 
looking at the ISMF data set or volume list. 


What DFDSS Copies 
DFDSS copies only used space for SAM or PAM data sets and data sets with null 
DSORG fields (X'0000'), unless overridden by ALLDATA or ALLEXCP. Use the 
ALLDATA(*) and ALLEXCP parameters to process allocated space if: 


¢ You are not sure of the data set organization (DSORG) of a data set on a 
volume when doing a full-volume COPY. 


¢ There are SAM, PAM, or data sets with null DSORG fields (X'0000') that are 
not accessed using SAM or PAM. 


Note: The COPY command requires temporary work space. Be sure public or 
storage volumes are available. Some temporary data sets are allocated to 
nouspecific devices by referring to SYSDA andjor SYSALLDA generic groups. If 
DFDSS its to function, these allocations must be allowed by the installation. 
Atiocation validation exits to SVC 99 must not restrict DFDSS allocations. 


Moving Data Sets 


Using the COPY command with the DATASET keyword, you can copy one or more 
data sets from one DASD volume to another of like or unlike device type. If you 
specify the DELETE keyword with COPY, the data set on the source volume is 
deleted when it has been successfully copied to the target volume. In this way, you 
can perform a data set move. 
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Specifying Input Volumes 
For DATASET COPY, input volume speenenuon’s is not coors If you do not 
specify input volumes, data sets are selected from all the data sets cataloged in the 


standard search order. 


If you do specify input volumes (but not ALLMULT)), catalogs are used to select 
only data sets that reside in their entirety on the volumes you specify with 
INDDNAME, INDYNAM, LOGINDDNAME, or LOGINDYNAM. 


If you specify input volumes, a data set is selected if any of the following apply: 


¢ Its volume sequence number is 1, its last volume flag is off, and it is cataloged in 
the standard catalog search order. 


e Its volume sequence number is 1, and its last volume flag is on. 


e [tis a multivolume non-VSAM data set, all the volumes on which it resides are 
specified in the INDDNAME, INDYNAM, LOGINDDNAME, or 
LOGINDYNAM parameter, and it is cataloged in the standard catalog search 
order. 


e Itis a VSAM cluster and all volumes for all components are specified. 


If a data set is found on more than one specified input volume and the volume 
sequence numbers match, DFDSS cannot determine which data set is to be selected 


for processing. 


Output Volume Selection 
Specifving output volumes is required for DATASET COPY in a non-SMS 
environment. (For a discussion of SMS considerazions for moving data, see 
“Considerations for Moving Data Sets in an SMS Environment” on page 86.) 


With the OUTDDNAME or OUTDYNAM keywords. you can specify multiple 
target Vv olumes. This allows you to specify spill volumes. These spill volumes are 
e data sets you are moving require more space than is available on your 


If the output volume has unexpired data sets, you can either not process the data 
sets Or write over them. . 


Renaming Data Sets 
You can rename data sets bv using the yaa kevword of the COPY 


command. For VSAM data sets, you can rename oniv clusters. The new name for 
the components of VSAM clusters is derived by DFDSS. [f the old component 
names were derived by the system, the new component names are derived by using a 
similar mechanism. If the component names were derived by using the cluster name 
(such as clustername.data or clustername.index), the new component names are 
similarly derived: however, if the new component name exceeds 44 characters, then 
the new component names are derived by using the naming convention of the 
system. 


Chapter 8. Managing Data Movement with DFDSS 75 


Moving to Preallocated Data Sets 


In some cases, you might want to COPY data sets to preallocated targets. Note, 
however, that CVOLs, integrated catalog facility catalogs and system data sets that 
are named SYS1.* cannot be copied to preallocated data sets unless the 
PROCESS(SYS1) keyword is specified. 


Rules for Moving to Preallocated Target Data Sets 
The rules for moving VSAM and non-VSAM data sets to preallocated data sets 
follow. 


VSAM Preallocation 


An existing data set qualifies as a preallocated target for data set COPY if the 
cluster name matches and the complete cluster is available on target volumes. 


The preallocated data set is usable if: 


The user is authorized to update the target data set. 

The cluster types match. | | 

The number of components match. 

The key length and offset match. 

The KEYRANGES match. 

None of the components are multivolume. 

Sufficient space is available for each component. 

KSDS data sets are reusabie or empty. 

Key range data sets are empty. 

The data set is in the catalog structure, if required for the COPY. 


The data set has no alternate indexes (AIXs) or paths defined over it (except for 
a single path defined directly over the base cluster). 


Non-VSAM Preallocation | 
An existing data set qualifies as a preallocated target for data set COPY if the 
Format | DSCB names match, the complete data set is available on target volumes, 


and: 


Cd 


For singie volume target qualification. the DSORG is PAM or the DSIVOLSQ 
is | and the last volume flag ts on. 


For multivolume target or single volume target with the last volume flag off, the 
data set is cataloged in the standard order of search. All volume serial numbers 
returned by a LOCATE on the data set are in the output volume list. 
(Candidate volumes for which no Format | DSCBs exist are acceptable.) 


The preallocated data set is usable if: 
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The user is authorized to update the target data set. 
The DSORG matches. 


For BDAM data sets, the target does not exist if COPY is done using the 
IEHMOVE utility. If REBLOCKADDRESS is specified for the data set, 
preallocated targets are allowed. 


e For unmovable data sets, extents match exactly when you copy to a like device 
without specifying the FORCE keyword. 


¢ For movable data sets or unmovable data sets with FORCE, sufficient space is 
present in the target data set. 


¢ For PAM data sets, the target directory can contain all source members and 
aliases. 


¢ For preallocated standard user label data sets, the target has more than one 
extent when the source data set has more than one extent. 


If a VSAM or non-VSAM preallocated data set is determined to be unusable, 
message ADR439E is issued, and the COPY is stopped for that data set only. No 
attempt is made to clear or alter the target data set if: 


¢ The source data set is empty. 
¢ The DSORG Is not supported. 
e The target is preallocated but not empty. 


Message ADR363E is issued to mform the user. 


Specifying Multiple Target Volumes 
When muitiple target volumes and REPLACE are specified, more than one existing 
data set may qualify as a preallocated target. The first existing data set that 
qualifies as a preallocated target when you use the OUTDDNAME/OUTDYNAM 
list order is used as the target data set. For non-VSAM data sets that require 
catalog verification, the catalog standard order of search determines the data set 
used as the preallocated target. 


Tre device selection criteria used for data set COPY (like. same, then unlike device 
preference) is not observed if a preallocated data set target is used. 


How Keywords Work with Preallocated Targets 
When vou use preallocated data sets with COPY. some keywords have a different 
effect and others have no effect at all. 


ALLEXCP and ALLDATA: If ALLEXCP or ALLDATA 1s specified and the target is 
a like device, the data in the source data set is moved to the target. 


CATALOG and RECATALOG: Daia set COPY cannot change the catalog or the 
catalog status (cataloged or uncataioged) of the preallocated target data set. Asa 
result. the CATALOG and RECATALOG keywords have no effect on preallocated 
target data sets. (Similarly, passwords and expiration dates of preallocated data sets 
cannot be changed.) 


NOPACKING: The NOPACKING keyword ts effective only for partitioned data 
sets. If NOPACKING is specified for preallocated partitioned data sets, the 
preallocated target must reside on the same or like device. Processing is stopped for 
the data set if the target resides on an unlike device. The target is not deleted and 
reallocated. 


PROCESS(SYS1): Data set COPY permits moving SYSI data sets to a preallocated 
target. 
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PERCENTUTILIZED: The PERCENTUTILIZED keyword also has no effect when 
the target data set is preallocated. 


REBLOCK: Ifa data set qualifies for reblocking when REBLOCK is specified 
(SAM and PAM only) and a preallocated target is used. the target block size is 
overwritten with one of the following values: 


e The source data set block size 

e A DFDSS-selected block size 

* A user-selected block size passed by the installation reblock exit 
e <A system-determined block size. 


The block size used is determined by the installation reblock exit return code and the 
reblockable indicator in the Format | DSCB. 


If REBLOCK is not specified, the target BLKSIZE of a non-VSAM data set is 
overwritten with the source BLKSIZE. 


If a partitioned data set is specified with both NOPACKING and REBLOCK 
keywords, the data set is not reblocked. 


RENAMEUNCONDITIONAL: RENAMEUNCONDITIONAL has no effect for 
preailocated target data sets. 


Note: Data set COPY does not scratch and reallocate preallocated data sets. 


7s ee how profiles should be defined. when you move data without 
fying MENTITY with COPY and have RACF Release 1.5 or later instailed. 


Defining RACF Profiles 





No RENAME No RENAME RENAME RENAME 
No DELETE DELETE No DELETE DELETE 
Unprotected source No protiie to No profile to No profile to No profile to define. 
e2hne, define. define. 
Generic profile for source Leave source eave source Leave source Leave source 
profile. No target profile. No target profile. 7 profile. 7 
profile to <efine. profile to define. 
Discrete profile for Leave source Delete source Leave source Delete source 
source orofile. Define profile. Define profile. Define a profile. Define a 
distrete tar set discrete target discrete target discrete target 
srofile. § profile. 8 profile. 8 profile. § 
Figure 27. Detining Profiles--with RACY 1.5 or Later Installed 


Por a prealiccated target data set. the RACF status is checked. If the source is 
protected bu: the target is not, DFDSS protects the target data set with a discrete 
RACF orolte. 





Issue RACHECK to determine if a generic or discrete profile already exists for the renamed target. If so. there is 
no profile to define. If not. a discrete crofile is defined. 


8 When a discrete profile exists for a preallocated target data set, that profile is not deleted and no new profile is 
defined. 


78  DFDSS: User's Guide 


Moving Data Sets with Special Requirements 


Some data sets require special treatment when they are moved. The following 
sections discuss some considerations for moving these special data sets. 


Moving Undefined DSORG and Empty Data Sets 
To copy a data set with undefined DSORG, ensure that the 
PROCESS(UNDEFINEDSORG) keyword is specified. In addition, the selected 
target volume must be of like-device type or of an unlike-device type with equal or 
greater track capacity. 


To copy an empty data set (DSILSTAR =0, DSIEXT1— =0, DSVLSEQ= 1), an 
EOF record must exist in the first track of the source data set. To copy an empty 
data set, use ALLDATA or ALLEXCP to force a copy of all allocated space in the 
data set. Ensure that the selected target volume is of like-device type, and the data 
is not being reblocked. 


Moving System Data Sets 
° Some system data sets do not require movement, either because they are allocated 
during system generation or because they are built at IPL time. Other system data 
sets. however, can be moved bv DFDSS for various reasons. 


Unless excluded, system data sets are copied. However, they generally remain open 
while the system is running and cannot be scratched or uncataloged because 
DELETE and UNCATALOG apply only to data sets not in use. 


Frequently system data sets are prefixed with a high-level qualifier of SYS1. 
Previousiy. DFDSS placed restrictions on the precessing of SYS1 data sets. however. 
DFDSS Version 2 Release 5.0 removes some of these restrictions by using the 
PROCESS(SYS1) keyword. The PROCESS(SYS1) keyword can be used for a data 
set COPY of a SYS] data set to move it to a preallocated target or to copy it with 
the DELETE option. PROCESS(SYS!) does not apply to VTOCIX or VVDS. 


To limit the use of PROCESS. vou need to set up a RACF facility class profile. 
Refer to Resource Access Control Fucility (RACF,) Security Administrator's Guide for 
more information on RACF facility class profiles. 


Note: The PROCESS(SYS1) option does not lift the restrictions on the processing 
of volume VVDSs or VTOC indexes. 


When the PROCESS(SYS1) keyword ts not specified, you cannot move svstem data 
sets the way you normally move data sets with DFDSS. In order for DFDSS to 
move system data sets. you must do one of the following: 


* Dump the data sets, and then restore them to a different volume. 
* Copy the data sets to a different volume and then catalog them in a different 
catalog. 
Note: When a data set COPY is used to copy the following data sets, space is 
defined for the target data set but no data is copied: 


Model DSCBs 
Page and swap data sets 
SYSI.STGINDEX. 
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Moving User Catalogs 


When you copy an integrated catalog facility user catalog, DELETE must be 
specified, and an input volume and the RENAMEU keyword must not be specified. 
You must specify the fully-qualified name of the user catalog in the INCLUDE 
parameter. In any processor in the compiex. there should be no other jobs executing 
that access the user catalog being moved; otherwise, the COPY operation might fail 
or the copied catalog might contain errors. 


The operator is prompted to enter the password for the system’s master catalog. If 
the master catalog was defined with ATTEMPTS=0. you must RACF-protect the 
master catalog so that password prompting is bypassed. 


For integrated catalog facility clusters that will be copied using the IDCAMS utility, 
a preallocated target data set will be renamed using a DFDSS generated temporary 
name. This allows dynamic allocation and IDCAMS REPRO to work, because both 
are currently undirected in catalog usage. 


An integrated catalog facility cluster with AIX and path associations does not use a 
preallocated target if DELETE 1s specified. No search is made for existing data sets 
in this case. An integrated catalog facility ATX cannot use a preallocated target. No 
search is made for existing data sets when copying an AIX. 


With MVS/XA DFP Version 2 Release 3 or a later release, user catalog aliases are 
automatically redefined after the copy. The LOCK attribute of an integrated catalog 
facility user catalog is preserved during the copy. See Catalog Administration Guide 
for a description of the LOCK attribute and the proper access authority. 


Moving CVOLs: When vou move a CVOL. DELETE must be specified and 
RENAMELU mus: not oe ee nied. The CATALOG parameter ts used as a default. 
you must rebuild cataiog aliases afterward 

Note: DFDSS cannot be used to move an active VSAM master catalog, the VVDS. 


ew tha VWTRATIY 
ar the VTOCIX. 


eas AL 


Moving Multivoiume Daia Seis 


When moving multivolume data sets, you should use the ALLMULTI keyword on 
the COPY command. ALLMULTI allows you to move muitivolume data sets in 
their entirety, even if vou do not specify all the volumes on which the data set 
resides. To use ALLMULTI,. however, vou must specify at least one primary input 
volume on the I LOGIN DDNAME or Aen volume lists. The data set 


in order to quaufy for ALL MULTI processing. 


be copied to a single volume or to multiple volumes. 
did Set with stundard aiser labe:. only the me user label on 
the rst volume is copied to the target volumes. 


rom 





Moving VSAM Data Seis 


When vou move 2 VSAM data set. DELETE, RENAMEU. or RECATALOG (to a 


different catalog than the source catalog) must be sf ecified if REPLACE is not 
sp if ed. Ii REPLACE ts specified and a preallocate ed target is not found, then 


ec 
DELETE. RENAMEL. or RECATALOG (to a different catalog than the source 
cufalog) must be specified for the data set to be processed. 


80. DFDSS: User's Guide 


You can move the base cluster, all associated alternate index clusters, and paths by 
using the SPHERE keyword with the COPY command. “Restrictions for COPY” 
on page 114 lists considerations for moving VSAM spheres. 


If you do not use the SPHERE keyword and the base cluster has associated alternate 
index clusters, only the base cluster 1s moved as follows: 


e If you specify DELETE, only the base cluster is moved, but the alternate index 
cluster continues to be related to the base cluster. 


¢ If DELETE is not specified, a second copy of the base cluster is created, and the 
alternate index cluster continues to be related to the original base cluster. 


To move an alternate index cluster, DELETE must be specified on the COPY 
command. Only the alternate index cluster is moved and it continues to relate to its 
base cluster. An AIX cannot be moved by itself to or from an SMS-managed 
volume. 


For an empty VSAM data set (zero data relative block address or zero record 
count), the data set is defined on the target volume but is not copied. Message 
ADR474W is issued for the data set. 


During COPY, you can specify the password of the catalog instead of the password 
of each data set. If you specify the passwords of both the data set and the aie 
the data set password is used to check authorization. 


Note: DFDSS does not preserve candidate volumes during COPY processing. 


Moving a PDSE 
In DEDSS Version 2 Release 5. the COPY command can be used to move a PDSE. 
The new CONVERT keyword along with the new PDSE and PDS subkeywords can 
be used with COPY to convert a PDS to a PDSE and vice versa. 


The PDSE cannot be moved by using releases prior to DFDSS Version 2 Release 5. 
nor can they be moved on a system using releases pnor to MVS;DFP Version 3 
Release 2 and MVS SP Version 3 Release 1.0E. 


Moving a Damaged PDS 
Partitioned data sets are monitored by DFDSS during track packing for conditions 
that are not normal. The following conditions are detected and reported: 


« Missing high key entry in the PDS directory 
¢ Missing directory EOF 
* Invalid member start TTR 


— TTR points before directory EOF 
— TTR points after end of data set. 


e Missing member EOF (each member of a partitioned data set is normally ended 
by an EOF record) 


¢ [Invalid note or notelist TTR 


— Note pointing before the start of member data 

— Note pointing after the member EOF 

— Note pointing past the last valid record on a track 
~ Note pointing to record 0 ofa track. 
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DFDSS notes all these conditions with a message. 


During track packing, DFDSS repairs missing high key directory entry, missing 
directory EOF, and missing member EOFs. 


Invalid start TTRs prevent DFDSS from track packing data for that member. 
DFDSS translates all valid note and notelist TTRs during track packing. 


Damaged partitioned data sets can be moved to same or like device target volumes 
by using tne NOPACKING keyword. This results in an exact track-for-track image 
of the source data set. Obviously, no compression is performed in this case. 


Moving Unmovable Data Sets 
When copying unmovable data sets to like devices, DFDSS places them at the same 
track locations on the target volume under the following conditions: 


¢ The operating system is MVS/XA DFP Version 2 Release 1 or later release. 
¢ The target volume has an indexed VTOC. 
¢ The space where the unmovable data would be placed is available. 


If any of these conditions do not exist, you must specify the FORCE keyword to 
move the data set. FORCE enables DFDSS to treat the unmovable data set as 
movable and also move it to an unlike device. Because DFDSS places the data set 
in any available location when FORCE is specified, use FORCE with caution. 


If some data sets have CCHHR (cylinder. cylinder, head, head, record) 
location-dependent data and you are using FORCE, you should exclude these data 
sets with <ze EXCLUDE keyword to prevent DFDSS from moving 
iocation-cerendeni data sets. 


Another wavy to position data sets in a specific location on a volume 1s to allocate all 
space on ine target volume except where you plan io piace the unmovable data sets. 


Then meve the unmovable data sets with FORCE and afterwards scratch the 
dummy space allocation. 


Moving ISAM Data Sets 
When an ISAM data set is being moved, the target data set has the prime, index, 
and overflow areas combined into one allocated area. except when the target data set 
can be aliccated to the same location as the source data set. You must move an 
ISAM daze set to a volume with an indexed VTOC. To guarantee a successful 
allocation. vou should make certain that there is no otmer activity on this volume. 


For a sinz.e-volume ISAM data set to be selected. either the last-volume indicator 
q 


must be on ar the data set must be cataloged. 


Moving BDAM Data Sets 
When TTR-organized BDAM data sets are copied to unlike devices, the target 
device mus: have a larger track capacity than the source. and the target data sets 
must not ce preallocated. 


DFDSS urdates BDAM data sets organized by relative byte address (RBA) when 
copying them. The only other kind of data set with location-dependent data that 
DFDSS c2n copy to an unlike device is a PAM data set with NOTE lists. Also, 
DFDSS cannot be used to copy any data sets containing location-dependent data to 
like devices unless they are defined as unmovable and FORCE keyword criteria are 
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met. DFDSS updates the block reference count of dummy records contained within 
RBA-organized BDAM data sets when copying them to unlike devices of smaller 


track capacity. 


Moving GDG Data Sets | 
For generation data group (GDG) data sets, filtering on generations is supported. 
You can specify generation names in relative generation number, dsn(n), with the 
INCLUDE and EXCLUDE keywords. During COPY, if you catalog the GDGs in 
a different catalog or you rename them, you must define ahead of time the target 
GDG base name because the source GDG base name is unusable. 


Moving Generation 


SMS ACTIVE | . 
| | MOVE | ACTIVE 

| | COPY | DEFERRED 
| | SMS DEFERRED 

! | | MOVE | DEFERRED 
| | COPY DEFERRED 
! | | ROLLEDOFF 

| ! MOVE ROLLEDOFF 


Data Sets to SMS Volumes 
An SMS-managed generation data set (GDS) can be in one of three states: 


¢ DEFERRED 


¢ ACTIVE 


¢ ROLLED-OFF. 


When copying a GDS to an SMS-managed volume and the data set is not 
preallocated, DFDSS allocates the target GDS as follows: 


e If DELETE is specified and RENAMEU is not specified, the target GDS is 
allocated with the same state as the source GDS. 


¢ Ifthe TGTGDS keyword is specified, the appropriate status is assigned to the 
data set. The requested target status must not violate rules of the generation 


data group. 


The following chart describes the default situation for DF DSS to allocate the 
SMS-managed GDG data set (MOVE refers to COPY with the DELETE keyword 


specified): 
Target | Source Source | DFDSS ——-TGTGDS 
Environment Environment Status Function Default 













Non-SMS 





Cataloged 


Not cataloged 





: COPY 

















| DEFERRED 
| ACTIVE : 
















| DEFERRED 








If the data set is preallocated, the state of the target GDS is not altered. During a 
move operation, you can use the TGTGDS keyword to alter the target status only if 
the data set is also being renamed. 
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Moving Generation Data Sets to Non-SMS Volumes 
; A non-SMS-managed generation data set (GDS) can be in one of two states: 


¢ Cataloged 
* Uncataloged. 


When you copy a GDS to a non-SMS volume, the state of the GDS is determined 
only by the CATALOG or RECATALOG keywords. 


Moving Volumes 
You can move volumes logically or physically with DFDSS. 


As with moving data sets, if the output volume has unexpired data sets, you can stop 
the COPY operation or write over the unexpired data sets. 


Logical Volume COPY 

To move a volume logically, use the DATASET keyword, specify input volumes. 
with LOGINDDNAME, LOGINDYNAM, INDDNAME, or INDYNAM, and use 
INCLUDE(**). This method of moving volumes allows you to move data between 
unlike devices (for example from a 3350 to a 3380). 


Some data sets require special processing when you move them (see also “Moving 
Data Sets with Special Requirements” on page 79). For example: 


Unmovable data sets 

Multivolume data sets 

Integrated catalog facility catalogs 

Data sets beginning with SYSI 

Data sets used by device-dependent application programs. 


If vou use DATASET COPY to move a volume and the volume contains such data 
sets. you must move them in the proper sequence to achieve the expected results. 


You may want to process unmovable data sets first so you can place them at the 
same track location on the target device. User catalogs should be moved only when 
quiesced. In addition, you should not move catalogs together with the data sets 
cataloged in them. 


Note: Some data sets are not eligible for movement by DFDSS (for example, 
VSAM data sets not cataloged in integrated catalog facility catalogs). Others might 
require special parameters (for example. unmovable data sets). 


Physical Volume COPY 
If vou do not specify DATASET or TRACKS on the COPY command, the COPY 
defaults to FULL and moves the volume physically. You must also specify 
INDDNAME or INDYNAM to indicate the source volume and OUTDDNAME or 
OUTDYNAM to indicate the target volume. FULL volume COPY can move data 
only between like devices of equal or greater capacity (for example. from a double 
capacity 3380 model to a double or triple capacity 3380 model). 
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Notes: 


While it is true that in most cases you can physically move volumes only 
between like devices, you can move: 


i. From an IBM 3330 Model | to an IBM 3330 Model 11 


2. From an IBM 3340 with 35-megabyte capacity to an IBM 3340 with 
76-megabyte capacity or to an IBM 3344 


3. From a smaller capacity IBM 3380 model to a larger capacity IBM 3380 model 


4. From a minivolume or virtual volume to a real volume of like device type, and 
vice versa, device capacity permitting. 


With tracks COPY you can move data: 
. From an IBM 3330 Model 11 to an IBM 3330 Model 1 
. From a 70-megabyte 3340 to a 35-megabyte 3340 


a HD WN 


. From a larger capacity IBM 3380 model to a smaller capacity IBM 3380 model, 
provided the range of data to be processed falls within the capacity of the output 
device. . 


When you perform a full-volume copy to a DASD that is shared between muitiple 
systems, the DASD should be offline to all systems except the one performing the 
copy. 


When you use physical volume COPY, you can specify COPYVOLID (see 
“Considerations for Moving Volumes in an SMS Environment” on page 89 for SMS 
considerations). If you specify COPYVOLID, the volume serial number of the 
source volume is copied to the target volume. This ensures that RACF profiles and 
catalog entries for the data sets on the volume have the correct voiume serial 
number. 


Note: However, changing the volume seriai number of a volume causes the 
operating system to demount the target volume at the end of the COPY operation. 
To use the target volume. you must demount the source volume and mount the 
target volume. 


VTOC Considerations | 
When moving volumes, you need to make certain that the VTOC on the source 
volume is large enough to hold entries for ail the data sets to be placed on it. A 
DFDSS physical volume COPY copies the VTOC from the source to the target 
volume. If you determine that this VTOC is too small for the target volume (for 
example. if you are moving from a standard capacity 3380 model to a double 
capacity 3380 model). use ICK DSF to reinitialize the target volume with a larger 
VTOC. Then use DATASET COPY to move the data sets to the target volume. 


If you use DFDSS Version 2 Release 3 or a later release to perform a physical 
volume COPY from a smaller capacity to a larger capacity volume on a like device, 
the Format 5 DSCB is updated to reflect the size and number of the allocated/free 
DSCBs of the target volume. DFDSS sets a bit on in the Format 4 DSCB of the 
target volume that indicates that the associated Format 3 DSCB needs an update. 
This update occurs the next time a data set is allocated to the volume. If the source 
volume has an indexed VTOC, the target volume’s corresponding Format 4 
indexed-VTOC bit is turned off. The actual VTOC index data set is copted. 
DFDSS Version 2? Release 3.0 causes the Format 5 DSCB to be updated and calls 
ICKDSF to rebuild the indexed VTOC. 


Chapter 8. Managing Data Movement with DFDSS © 85 


Moving Volumes to Like Devices of Equal Capacity 
When you move volumes to like devices of equal capacity, you can use logical or 
physical COPY. 


Moving Volumes to Like Devices of Greater Capacity 
If you allocate a VTOC on a larger capacity volume, it is preserved when moving 
from a smaller capacity volume of a like device. DFDSS uses this VTOC when 
copying the source data sets. When the full-volume COPY is complete, additional 
data sets can be placed on the target volume. 


Moving Volumes to Unlike Devices 
When moving data between unlike devices, you must use logical processing. If you 
specify DATASET with COPY, DFDSS does a logical COPY. To copy all the data 
on a volume logically, you also need to specify input volumes with 
LOGINDDNAME, LOGINDYNAM, INDDNAME, or INDYNAM. 
(LOGINDDNAME or LOGINDYNAM is required if you are also using 
ALLMULTL) 


Considerations for Moving Data Sets in an SMS Environment 


When moving data sets and volumes in an SMS environment, there are some special 
considerations. 


As discussed earlier, volumes within an SMS environment may or may not be 
managed by SMS. The following sections discuss how you can use the COPY 
command to move these data sets. 


Moving SMS-Managed Data Sets 
As with the RESTORE command. COPY invokes the Automatic Class Selection 
(ACS) routines, which in turn assign or override a data set’s classes. 


When you use the COPY command. vou are in the ACS ALLOC environment 
(&ACSENVIR = 'ALLOC'). The storage class ACS routine is executed first. If the 
storage class assigned is not null, the management class ACS routine and then the 
storage group ACS routine are executed. (See “ACS Variables Available during 
COPY” on page 109 for a list of variables available to ACS routines during COPY 
processing.) 


If vou do not specify otherwise, DFDSS passes the source data set’s class names as 
input to ACS. If you want to specify storage and management class names to be 
passed to ACS, you can use the STORCLAS and \{GMTCLAS keywords. You can 
use the NULLSTORCLAS and NULLMGMTCLAS keywords to pass null storage 
and management classes to the ACS routines. 


If you do not want a data set to be SMS managed. vou should specify BY PASSACS 
and NULLSTORCLAS. 


All of these keywords work the same for COPY as they do for RESTORE (see 


“Changing Storage Class with RESTORE” on page 65 and “Changing Management 
Class with RESTORE” on page 66). 
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Target Volume Selection 
In some cases, you might want to move data sets off some volumes and onto others 
(for example, because of performance problems or because you want to put data sets 
on some new, empty volumes you have just added to a storage group). However, in 
an SMS environment you generally allow the system to place data sets for vou. If 
for some reason you want to control the placement of the data sets, you must take 
special steps. 


If you ue OUTDDNAME or OUTDYNAM to specify a volume list, the volume 
serial numbers are passed as input to the ACS routines. Depending on how your 
ACS routines are written, this input might or might not be used in determining 
where to place the data set. 


One way to guarantee that data sets go to particular volumes is to write your storage 
group ACS routine such that data sets are moved to the volumes you select. 


Alternatively, if a data set’s storage class has the guaranteed space attribute, the data 
set is placed on the user-specified volumes if the volumes reside in the same storage 
group and ACS selects that storage group for the data set. By using BYPASSACS 
and STORCLAS, you can ensure that the storage group selected contains the 
volumes you specify with OUTDDNAME or OUTDYNAM. However, for this 
procedure to work, your storage group ACS routine must use storage class to 
determine the storage group for a data set. This ailows you to determine which 
storage class to specify with STORCLAS to ensure that the storage group containing 
the volumes specified with OUTDDNAME or OUTDYNAM is selected. 


Changing Storage Class with COPY 
You can use the STORCLAS keyword to specify 2 storage class name for DFDSS to 
pass to ACS. You can specify NULLSTORCLAS if vou want DFDSS to pass a 
null storage class to ACS. 


Note: RACF checks if the RESOWNER of a given data set is authorized to define 
the data set with the specified STORCLAS. Ensure that the RESOWNER of the 
data set has the proper authority to use the indicated storage class. 


Using STORCLAS does not guarantee that the data set is assigned the storage class 
you specify. To be certain that the storage class you specify is assigned to the data 
set. you must specify BYPASSACS. In this case, using BYPASSACS causes the 
storage class and management class ACS routines to be bypassed. so the data set ts 
assigned whatever you have specified with STORCLAS or, if you don’t use 
STORCLAS, whatever the source data set's storage class is. However, when you use 
BYPASSACS, you should make certain that the storage class you specify is valid or 
vou will get an error. 
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You can also use STORCLAS and BYPASSACS to move data sets into a newly 
defined storage class. For example, suppose you want to combine all your storage 
classes except two into one new, large storage class. You can code the following: 


se  -. 


COPY - 
_. DATASET(INCLUDE(**) .- 
BY (STORCLAS NE, (SCNAME1,SCNAME2))) - | 
STORCLAS(SCNAME3) - 
| BYPASSACS(**) - 


| DELETE | 


If you specify NULLSTORCLAS and BYPASSACS together, the target data set is 
non-SMS managed. 





Changing Management Class with COPY 
In addition to influencing a data set’s storage class with COPY. you can also give 
ACS input for assigning or overriding the data set’s management class. By 
specifying MGMTCLAS, you can pass a management class name to ACS and, as 
with STORCLAS. ACS ignores it. assigns it to the data set. or uses it in 
combination with other things to determine the data set's management class. By 
specifying NULLMGMTCLAS, you can pass null management class to ACS, which 
might or might not assign a management class to the data set. 


Note: RACF checks if the RESOWNER of a given data set is authorized to define 
the data set with the specified MGMTCLAS. Ensure that the RESOWNER of the 
data set has the proper authority to use the indicated management class. 


Also just as with STORCLAS, vou can use MGMTCLAS with BYPASSACS to 
make certain that the data set is assigned the management class you specify. If you 
use BYPASSACS. you should be certain that the management class you are giving 
the data set is valid. If itis not. the data set is not moved. You must de authorized 
to use BY PASSACS and the management class you specifv with MGMTCLAS. 


When you use COPY to influence or assign a management class, you also need to be 
careful that the data set resides in a storage group capable of providing for the 
management class attributes associated with the management class you specify. For 
instance, if a data set has a management class that makes it eligible for migration, it 
needs to reside in a storage group on which DFHSM does migration. Otherwise, the 
data set wii never be migrated. For this reason, vou might have to change the 
storage class along with the management class to ensure that the data ser resides on 
volumes that can accommodate its management class. 


Moving Non-SMS-Managed Data Seis 
If the data set you are moving is to be non-SMS managed. you should use the 
NULLSTORCLAS and BYPASSACS keywords on the COPY command. By using 
these keywords, you can make an SMS-managed data set non-SMS managed. Using 
NULLSTORCLAS and BYPASSACS also prevents a non-SMS-managed data set 
from becoming SMS managed. 
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Considerations for Moving Volumes in an SMS Environment 


When you move volumes physically, you must specify COPYVOLID if the source is 
an SMS volume. 


You must consider several factors when copying volumes in an SMS environment. 
Before you start to copy a full volume, you must ensure that the status of the target 
volume is synchronized with its environment. For example, if the target volume is a 
non-SMS volume, then the volume must not be defined in a storage group. 
Conversely, if the target volume is an SMS volume, then the volume must be defined 
in a storage group. Finally, if the target volume is SMS, then SMS must be active 
for the full-volume copy operation. 
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Chapter 9. Converting Data to and from SMS Management 


DFDSS is the primary tool for converting data to and from SMS management. 
Conversion can be done with or without data movement. 


This chapter is organized as follows: 


e “Evaluating Conversion to SMS Management” discusses the advantages and 
disadvantages of the two types of conversion. 


e “Conversion by Data Movement” on page 92 describes how to use DFDSS to 
convert data sets to SMS management with the COPY and DUMP/RESTORE 
commands. 


¢ “Conversion Without Data Movement” on page 93 describes how to use DFDSS 
to convert volumes to SMS management with the CONVERTV command. 


e “Special Data Set Requirements for Conversion to SMS” on page 96 describes 
some of the data sets that have special rea eae for conversion to SMS 
management. 


¢ “Converting from SMS Management without Data Movement” on page 98 
describes how to use the CONVERTV command to convert volumes from SMS 
management. 


¢ “Special Data Set Requirements for Conversion from SMS” on page 98 describes 
some of the data sets that have special requirements for conversion from SMS 
management. 


Evaluating Conversion to SMS Management 


One of the first things to consider when you convert data to SMS management is 
whether to convert data sets with or without data movement. If vou have SMS 
volumes with sufficient free space. you can convert data sets by simply moving them 
from non-SMS volumes to SMS volumes. The same its also true if you are 
converting data from SMS-management. Converting data sets to SMS management 
ov data movement is often preferable because it allows the system to place the data 
sets for vou. This ensures that the data sets are placed on volumes in storage groups 
that can meet the availability and performance requirements of the data set. 


*. however. you do not have sufficient free space on your SMS volumes to convert 
oy data movement. you might have to convert data sets without data movement. 
The drawback to this method of conversion is that it does not allow the system to 
olace data sets for you. You must ensure that the availability and performance 
requirements of the data sets can be met by the storage group in which you oe the 
volume. 


Regardless of how you convert to SMS management, you must determine the 
eligibility for conversion of your data sets and volumes prior to conversion. 
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The following data sets cannot be converted to SMS management: 


ISAM data sets 

Absolute track allocation data sets 

Unmovable data sets 

Model DSCBs 

CVOLs 

Non-integrated catalog facility VSAM catalogs 
VSAM data sets not cataloged in an integrated catalog facility catalog 
Uncataloged, multivolume data sets 

SYS1 storage index data sets (SYS1.STGINDEX) 
Page and swap data sets 

BDAM with OPTCD=A 

VVDS/VTOCIX?. 


(Using CONVERTV with the SMS and TEST keywords identifies ineligible data sets 
without actually converting any data.) 


Volume Eligibility for Conversion to SMS 


A volume is eligible for conversion if it meets the following conditions: 


It is a DASD volume. 

It is permanently mounted and accessible online. 

It has an indexed VTOC. 

It is defined in an SMS storage group in an active configuration. 


Conversion by Data Movement 


B. using logical data set COPY or DUMP/RESTORE, you can move data sets 
between non-SMS and SMS volumes. When moving data sets to SMS volumes, 
COPY and RESTORE invoke ACS to assign classes to the data sets. This type of 
conversion to SMS allows the data sets to be placed on the most appropriate SMS 
volume. 


Converting to SMS Management by Data Movement 
W nen moving data sets to SMS-managed volumes, you can use the COPY or 
RESTORE commands. You can specify storage and management class names with 
the STORCLAS and MGMTCLAS keywords. You can also specify output volumes 
with OUTDDNAME and OUTDYNAM. DFDSS passes the class names and 
volume serial numbers to ACS, which might use them in determining the classes and 
piacement of the data set. 


Tris method of converting data sets to SMS management is similar to moving data 
sets in a SMS environment as described in “Considerations for Moving Data Sets in 
an SMS Environment” on page 86. 


Ir ,ou use COPY or RESTORE on a data set that 1s ineligible for SMS 
menagement, DFDSS puts it on a non-SMS volume. However. if you specify 


STORCLAS and BYPASSACS with COPY or RESTORE for a data set that is 
ineigible for SMS management, the COPY or RESTORE fails. 


9 VVDS;/VTOCIX data sets can be SMS managed. but DFDSS cannot be used to convert them. 
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JOBCAT and STEPCAT are not allowed when you process SMS-managed data sets. 
For data sets cataloged outside the standard order of search, use the INCAT 
keyword on COPY or DUMP to identify what catalog to search. Use the 
ALLMULITI keyword on COPY or RESTORE to convert multivolume data sets. 
This allows you to specify only the volume with the primary component on the 
LOGINDD or LOGINDY parameter. You can use the SPHERE keyword on 
COPY or RESTORE to convert entire VSAM spheres. 


Converting from SMS Management by Data Movement 
To take a data set out of SMS management with COPY or DUMP/RESTORE, you 
should specify the BYPASSACS and NULLSTORCLAS keywords. This forces 
DFDSS to make the data set non-SMS managed. 


Conversion Without Data Movement 


Conversion without data movement is divided into two phases: conversion of data 
sets and conversion of volumes. Convert data sets and the volumes they reside on 
without moving data by using the DFDSS CONVERTV command. You need to set 
up RACF facility class authorization to limit the people who can use the 
CONVERTV command. When you use the CONVERTV command to perform 
conversion, it attempts to convert all the data sets on the volume. After all the data 
sets are processed, the volume is placed in one of the following three states: 


¢ CONVERTED-—the volume and its data sets are converted to SMS 
management. A volume can be placed in this state with the CONVERTV 
command and the SMS keyword. 


¢ INITIAL—new allocations cannct be made to the volume and, although users 
can access their data sets, the data sets cannot be extended to other volumes. A 
volume may be placed in this state because you have used the CONVERTV 
command with the PREPARE keyword to reduce activity to the volume prior to 
conversion. A volume may also be placed in this state if you are attempting to 
convert it and it contains data sets that are not eligible for conversion. 


* NONSMS-—the volume and its data sets were taken out of the CONVERTED or 
the INITIAL state and are non-SMS managed. A volume can be placed in this 
state with the CONVERTV command and the NONSMS keyword. 


Simulating Conversion 
Before vou convert a volume to SMS management. you should simulate the 
conversion to ensure that all the data sets on the volume are eligible for conversion 
to SMS. In addition. simulating conversion shows you the classes ACS would assign 
to the data sets eligible for conversion. 


You can simulate conversion by using the CONVERTV command with the SMS 
and TEST keywords. If the volume ts ineligible for conversion, the data sets on the 
volume are still examined to determine their eligibility for conversion (provided the 
volume is permanently mounted and online). 


When you use CONVERTYV SMS TEST, you are in the ACS CONVERT 
environment (RACSENVIR='CONVERT'). Only the storage class ACS routine is 
executed. (See “ACS Variables Available during RESTORE and CONVERTY” on 
page 110 for a list of variables available to ACS routines during CONVERTV 
processing.) 
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Simulated conversion creates a report that identifies data sets ineligible for 
conversion. For a sample of this report, see “SMS Report” on page 95. Note that 
this report indicates the management, data, and storage class that would be assigned 
to each data set. Careful analysis of this report allows you to determine if your ACS 
routines will assign appropriate classes to the data sets before doing the actual 
conversion. 


Data sets unsupported by SMS should be moved off the volume prior to actual 
conversion. Other data sets (for example, uncataloged data sets) can be made 
eligible for conversion by taking some action (for example, using the CATALOG 
keyword to catalog uncataloged data sets). 


If you have ineligible data sets on a volume and you run CONVERTYV with SMS, 
DFDSS still converts the eligible data sets on the volume. It then puts the volume in 
the INITIAL state. You must then take action to make the ineligible data sets 
eligible for conversion or move them off the volume. Once all the ineligible data sets 
are dealt with, you can run CONVERTYV again to complete the conversion. 


Preparing a Volume for Conversion | | 
Before you convert a volume to SMS management, you should reduce the amount of 
activity to the volume being converted. CONVERTYV with the SMS keyword 
automatically places the volume in a state of reduced activity before doing the actual 
conversion. You might, however, want to reduce activity without doing the actual _ 
conversion (for example, if you want to simulate conversion). This is done by 
specifying the PREPARE keyword on the CONVERTV command. 


Specifying PREPARE prevents data sets from extending onto other volumes and 
new allocations from being made on the volume. However, users can still access the 
data on the volume from either the SMS system or a system sharing the volume. 


When you use PREPARE, a report is generated that tells you the volumes that have 
been placed in the INITIAL state. If any of the volumes are ineligible to be placed 
in the INITIAL state, the report also lists them and the reason they were ineligible 
(for example. they did not have an indexed VTOC or were offline). 


If you use the TEST keyword with PREPARE, you still get the report indicating 
which volumes would and would not be placed in the INITIAL state, but the 
PREPARE is not actually performed. You can then take some action to make those 
volumes eligible or simply not run PREPARE against those volumes. 


CONVERTYV with the NONSMS keyword reverses the effect of PREPARE and 
takes a volume out of the INITIAL state. 


Converting to SMS Management without Data Movement 
To convert data to SMS management, use the CONVERTY command with the SMS 
keyword. (Because SMS is the default for CONVERTY. you can simply specify 
CONVERTV.) Of course, the volume and all its data sets must be eligible for 
conversion to run CONVERTYV with SMS successfully. 


If the volume is eligible for conversion, the INITIAL indicator on the volume is set. 
This means the volume is in the same state as when you specify CONVERTY with 
the PREPARE keyword. Once a volume has its INITIAL indicator set on, DFDSS 
begins processing the data sets on the volume. 
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SMS Report 


If a data set is eligible for conversion, ACS is called to assign SMS classes to the 
data set. When you use CONVERTV with SMS, you are in the ACS CONVERT 
environment (&®ACSENVIR= 'CONVERT'). The storage class ACS routine is 
executed first. If the storage class assigned is not null, the management class ACS 
routine is executed. (See “ACS Variables Available during RESTORE and 
CONVERTV” on page 110 for a list of variables available to ACS routines during 
CONVERTYV processing.) 


RACE checks if the RESOWNER of a given data set is authorized to define the 
data set with the given STORCLAS and/or MGMTCLAS. Ensure that the 
RESOWNER of the data set has the proper authority to use the indicated storage 
class and/or the indicated management class. 


If no errors occur, the catalog entry for the data set is updated to include the classes. 
For VSAM data sets, the VVDS entry is updated to indicate that it is SMS 
managed. For non-VSAM data sets, a VVDS entry is added that indicates the data 
set is SMS managed. After the catalog and VVDS updates and additions are 
successfully made, the data set’s VIOC entry is updated to indicate it is SMS 
managed. : 


Ifa VSAM data set has the guaranteed space attribute, a check is done to verify the 
eligibility of its candidate volumes. If this check fails, the data set is not converted 
to SMS management. Non-VSAM data sets have candidate volumes in their catalog 
entries made non-specific. 


When DFDSS encounters a data set that is not eligible for conversion, it does not 
process the data set and it continues to process other data sets on the volume. The 
only time conversion of data sets stops is when an error prevents ACS from 
turning class information for any daia set. 


ra 
= 


~ 


DFDSS does not mark a volume as SMS managed until all the data sets on the 
volume are SMS managed. [fa volume contains data sets that are ineligible for 
conversion. you must take some action to make them eligible or move them off the 
volume. You can then resubmit the CONVERTV command to convert any data 


sets not uiready converted and mark the volume as an SMS volume. 


On subsequent invocations of CONVERTV, DFDSS processes only those data sets 
not yet converted unless you specify the REDETERMINE keyword. If 
REDETERMINE is specified, all the data sets. including those already converted. 
ure reprocessed. You may wish to do this if vour ACS routines changed since the 
last time sou ran CONVERTY on the volume. REDETERMINE causes DFDSS to 
reprocess ail the data sets on the volume. even the ones that were previously 


converted. 


Figure 28 on page 96 shows a sample report generated by DFDSS during 
CONVERTV SMS processing. 
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1PAGE 0001 DFDSS 5665-327 DATA FACILITY DATA SET SERVICES ¥2R4.0 88.140 16:23 





CONV SMS - 
AOR1011 RIG (01), TASKID 001 HAS BEEN ASSIGNED TO COMMAND 'CONY ' 
DDN(DASD52) - 
CAT 
SDRIO9I 231 (01), 88140 19:24:97 INITIAL SCAN OF USER CONTROL STATEMENTS COMPLETED. 


SADROOGI (001)-SETUP(O1), 88140 10:24:97 EXECUTION BEGINS 

OADREEGI (€01)-KYSMS(61), PROCESSING BEGINS ON VOLUME 058005 

GADR8731 (©61)-KVSMS(@1), VOLUME D5BQ05 IN STORAGE GROUP SG56 IS ELIGIBLE FOR CONVERSION TO SMS MANAGEMENT 
GADR8771 (861)-KYSMS(G1), THE FCLLOWING DATA SETS ON VOLUME D5B965 WERE SUCCESSFULLY PROCESSED 


9 DSCV. DDS. ESNVRS10 CATALOG: TEST.CAT.DSCV 
STORCLAS: SC5@ MGMTCLAS: MCCV 
3 DSCV.00S. KSNVRS10 CATALOG: TEST.CAT.OSCV 
| STORCLAS: SC50 MGMTCLAS: MCCV | 
AIX: DSCV.ATX.KSNVRS10 
PATH: DSCV.PATH.KSNVRS1O 
3 TEST.CAT .OSCV CATALOG: TEST.CAT.OSCV 
STORCLAS: SC5@ MGMTCLAS: MCCV 
1 3 DSCV.0DS. SSNNRS10 CATALOG: TEST.CAT.DSCY 
| STORCLAS: SC50 MGMTCLAS: MCCV 
| 9 DSCV.0DS. BDNNRS10 CATALOG: TEST. CAT.OSCV 
STORCLAS: SC50 MGMTCLAS: MCCV 
2ADR@BSI (001}-<VSMS(1), VOLUME 058005 HAS BEEN SUCCESSFULLY CONVERTED TO SMS MANAGEMENT 
| PAGE 0002 DFISS 5665-327 DATA FACILITY DATA SET SERVICES V2R4.9 88.140 10:23 
| -ADR892I (001}-KVRPT(Q1), THE STATUS OF EACH VOLUME IS AS FOLLOWS 
9 VOLUME FINAL STATUS REASON FOR FAILURE 
9 058605 - CONVERTED SMS | 
SADROL31 (001}-CLTSK(O1), 88140 10:25:07 TASK COMPLETED WITH RETURN CODE aa06 
QADRO12I DSSU (01), 88149 10:25:12 DFOSS PROCESSING COMPLETE. HIGHEST RETURN CODE IS a00 


Figure 28. SMS Report 





Special Data Set Requirements for Conversion to SMS 


Some data sets have special requirements for conversion to SMS management. The 
sections below describe the special considerations for converting these data sets to 
SMS management. 


VSAM Sphere Eligibility 
A VSAM sphere is considered to be a single data set by the CONVERTV command. 
As a result. either all the data sets of the sphere are converted or none of them are. 


If any of the following parts are ineligible for conversion, then all the components 
comprising the sphere are ineligible for conversion: 


* Any part of the VSAM base cluster 

¢ Components of a base cluster 

¢ AIXs related to the base cluster 

e AIX components 

¢ Paths relating AIXs to the base cluster. 


You must direct all parts of a VSAM sphere (the base cluster, base cluster 
components. AIXs. AIX components, and paths) to the same catalog by using an 
alias. If they are not directed to the same catalog, the sphere cannot be converted to 
SMS management. To correct this problem you can either rename the data sets in 
the sphere or add or delete catalog aliases and rerun the CONVERTV command. 
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oa Dada! 


Multivolume Data Sets 


GDG Data Sets 


If you do not specify ALLMULTI, all volumes must be included in DDNAME or 
DYNAM volume lists. 


Multivolume data sets are not eligible for conversion if any part of the data set 
resides on volumes that: 


¢ Do not have indexed VTOCs 

e Are not defined in a SMS storage group 

¢ Are defined to a different storage group 

e Are not permanently mounted and online. 


In addition, if the first volume on which a data set resides is not in the volume list, 
the data set is ineligible for conversion. 


When DFDSS encounters an extent of a multivolume data set, it processes the entire 
data set at that time, even though the extent might not be on the first volume of the 
data set. 


If you specify ALLMULTI, you need to specify only the volume containing the first 
extent of a non-VSAM data set. For VSAM data sets with ALLMULTI specified, 
the first extent of each data component, index component. key range, AIX data 
component, AIX index component, and AIX key range must be on a volume being 
converted. Otherwise, no part of the sphere can be converted. 


If these requirements are satisfied, DFDSS verifies that all the volumes on which the 
data set resides: 


e Are permanently mounted and online 
* Have indexed VTOCs 
¢ Are defined to the same storage group. 


If all these criteria are met. the data set is converted to SMS management. 


Note: Volumes not specified in the DDNAME or DYNAM volume lists will not 
aave the INITIAL indicator set on. 


If you do not specify ALLMULTI. DFDSS determines if all the extents of the data 
set reside on volumes in the DDNAME or DYNAM volume list. If an extent 
resides on a volume not in the list, the data set is not converted and DFDSS begins 
processing the next data set. If all the extents reside on volumes in the volume list, 
DFDSS determines the eligibility of the volumes. If the volumes are all eligible, 
DFDSS converts the data set to SMS management. Note in this case. the INITIAL 
indicator is set on for each volume containing an extent of the data set. 


Generation data groups (GDGs) require special consideration with cataloging and 
uncataloging during SMS conversion. Uncataloged GDGs are converted to SMS 
management. but are left uncataloged. Messages ADR877I and ADR879I indicate 
NOT CATALOGED for the catalog name in the data set name lists for SMS 
processing. 
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Temporary Data Sets 
Format | DSCBs of temporary data sets are updated to indicate uncataloged SMS 
status. 


VTOC and VVDS 
Format 1 DSCBs of the VTOC and VVDS are updated to indicate SMS 
management. 


Converting from SMS Management without Data Movement 


If you want to take volumes out of SMS management, you can use CONVERTV 
with the NONSMS keyword. All data sets on all volumes are eligible for NONSMS 
processing. After you execute this command, the volume indicators that designate 
the volume as a SMS volume are turned off. From then on, only 
non-SMS-managed data sets can be allocated to the volume. 


As with the SMS keyword, you can specify the TEST keyword with NONSMS. No 
conversion is actually done, but a report is generated that identifies the data sets that © 
are and are not eligible for conversion from SMS management. The report also 
indicates whether the volume as a whole is eligible for conversion from SMS 
management. 


To convert a data set from SMS management, the data set’s classes are deleted from 
its catalog entry. Non-specific volumes also are deleted from the catalog entry. For 
a VSAM data set, the SMS-related items are deleted from the VVDS entry. Fora 
non-VSAM data set, the VVDS entries are deleted. After the catalog and VVDS 
updates and deletions are made. the VTOC entry is updated to be non-SMS 
managed. . 


Notes: 


{. You cannot specify the CATALOG and REDETERMINE keywords with 
NONSMS. 


2, A PDSE its not supported in a non-SMS environment, therefore, a volume 
containing a PDSE cannot be converted to non-SMS. 


Special Data Set Requirements for Conversion from SMS 


When being converted from SMS management. some data sets require special 
consideration. The following sections discuss some of the special requirements for 
converting data sets from SMS management. 


Multivolume Data Sets 
All pieces of a multivolume data set must be converted from SMS management at 
the same time. You can do this by using the ALLMULTI keyword. For NONSMS 
processing. vou do not have to specify the volume on which the first extent resides 
when you use ALLMULTI. You need only identify one of the volumes on which 
the data set resides in the DDNAME or DYNAM volume list and the entire data set 
is converted. Those volumes not included in the volume list have their 
CONVERTED bits turned off, but their INITIAL bits are left on. Having the 
INITIAL bit on locks all allocations to the volume until all data sets residing on it 
are converted. 
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If you do not specify ALLMULTI, then you must specify all the volumes on which 
the data set resides in the DDNAME or DYNAM volume list. 


GDG Data Sets 


When you convert from SMS management, generation data group (GDG) data sets 
require special consideration with regard to cataloging. Data sets marked as 
“deferred roll in and rolled out” are uncataloged. 


Temporary Data Sets 
Format | DSCBs of temporary data sets are updated to non-SMS status. 


VTOC, VTOCIX, and VVDS 
Format 1 DSCBs of the VTOC, VTOCIX, and VVDS are updated to non-SMS 
Status. 
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Chapter 10. Managing Space with DFDSS 


You can use DFDSS to help manage your DASD space. This chapter is organized 


as follows: 
¢ “Reclaiming DASD Space” discusses how to use DFDSS to reclaim DASD 
space. 


« “Consolidating Free Space on Volumes” on page 104 discusses how to use the 
DEFRAG command to reduce fragmentation on volumes. 


Reclaiming DASD Space 
You can reclaim DASD space with DFDSS in the following ways: 
Releasing unused space in data sets. 


Compressing partitioned data sets to consolidate unused space at the end of the 
data sets and then releasing the unused space. 


Deleting unwanted data sets. 


Combining data set extents. 


Releasing Unused Space in Data Sets 
The RELEASE command releases, on specified volumes, allocated but unused space 
from all sequential and partitioned data sets that you select with INCLUDE, 
EXCLUDE. and or BY criteria. For an explanation of these criteria, see “Choosing 
Data Sets for Pracessing—Filtering™ on page 13. DFDSS selects only data sets that 
have releasable space. You can also use ISMF to build a list of data sets based on 
the amount of unused space and invoke DFDSS to release the unused space in them. 


he RELEASE function requires MVS/XA DFP Version 2 Release | or later 
release. (ISMF requires MVS;XA DFP Version 2 Release 2 or later release.) 


You should exciude, by using the EXCLUDE keyword, data sets whose DSILSTAR 
(last block pointer in the Format | DSCB) field is not maintained in the VTOC. 
This can occur if you use an access method other than BSAM, QSAM, or BPAM. 
DFDSS does not release space for data sets whose DSILSTAR field is 0. 


The following options can help you use RELEASE more effectively: 


MINSECQTY(n) Allows you to specify that space not be released unless 
the user’s secondary allocation is greater than or equal to 
n. In this way, you ensure that the user can still add to 
the data set after the RELEASE. 


MINTRACKSUNUSED(n) Allows you to specify that space not be released unless 
the number of unused tracks is greater than or equal to 
n. Without MINTRACKSUNUSED, space is released if 
there is one or more unused tracks tn the data set. 
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To protect the user, DFDSS does not release any space in a data set if: 
¢ The data set has 16 allocated extents. 


¢ The cylinder-allocated data set has unused tracks but not an entire unused 
cylinder. 


e The data set’s name begins with SYSI, unless the PROCESS(SYS1) keyword is 
specified. To limit the use of PROCESS, you need to set up a RACF facility 
class profile. 


| Compressing a PDS 


The COMPRESS command compresses a PDS on a specified volume. Compression 
removes unused space between members in a partitioned data set. This recovered 
space is then available for reuse at the end of the data set. Depending on the 
filtering criteria you specify, you can compress all the partitioned data sets or only 
some of the data sets. This command is useful for compressing system partitioned 
data sets before applying maintenance (thus avoiding certain space-related abends). 
You must not compress the data sets that contain DFDSS or IEBCOPY executable 
code. 


The actual PDS compression 1s done in place by using the IEBCOPY utility. To 
prevent loss of data if the system or IEBCOPY abnormaliy ends during processing, 
you should back up your volume or data sets that meet the filtering criteria before 
using this command. 


COMPRESS does not support processing partitioned data sets that: 


Are unmovable 
Contain track overflow records 
Have no directory. 


Deleting Unwanted Data Sets 


When used with the DELETE and PURGE keywords and data set filtering. a 
physical data set DUMP is a useful tool to delete unwanted data sets from DASD. 
This does not apply to VSAM data sets or to multivolume non-VSAM data sets. 


On a logical data set DUMP. when using the DELETE keyword, VSAM, 
non-VSAM. and multivolume data sets are deleted. 

Note: For a physical data set DUMP, cataloged VSAM data sets are not deleted 
with the DELETE function. 


The foilowing steps show how to delete (scratch and uncatalog) all expired data sets 
and all data sets that have not been referred to in the last year. The data sets are 
not actually moved to a dump volume. 


1. JCL requirement: 


eps Fre Sg ST NG EE LE Te a ee Ee SO eg ge Se ee es TT MI See AE a ee Tee ee 


| //NOTAPE 0D DUMMY 


The above prevents moving any data sets. 
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2. Control statements to delete (scratch and uncatalog) all data sets not referred to 
in the last year: 










DUMP INDD(111111) OUTDD(NOTAPE) - 
DATASET (BY (REFDT,LE,*,-366)) - 
DELETE PURGE 







3. Control statements to delete all expired data sets: 











DUMP INDD(111111) OUTDD(NOTAPE) - 
DATASET(INCLUDE(**) - 
BY(EXPDT,LT,*)) - 

DELETE 






Note: You can modify the above example to apply to VSAM and multivolume data 
sets by omitting the INDD statement or specifying LOGINDD. This results in a 
logical data set DUMP operation. 


Combining Data Set Extents 
The DUMP command used with the DELETE and PURGE keywords scratches and 
uncatalogs the data sets from DASD after they are dumped. If you restore those 
data sets to the same DASD, allocation attempts to get the space for the entire data 
set. If the DASD volume has sufficient contiguous unused space, the allocated space 
will most likely be in one contiguous extent. Because unmovable data sets are not 
deleted, however, the volume might be fragmented. preventing a complete 
RESTORE for all data sets. 


Ir you COPY those data sets to the same DASD. allocation attempts to get the 
space for the entire data set. If the DASD volume has sufficient contiguous unused 
space, the allocated space will most likely be in one contiguous extent. If you do not 
specify ALLDATA and ALLEXCP for sequential and partitioned data sets, only 
used spaces are allocated. 


Note: Do not use this technique for unmovable data sets such as ABSTR allocated 
or ISAM. 


The following steps show how to dump and delete (scratch and uncatalog) all 
movable non-VSAM data sets, defragment VSAM data sets, and restore all movable 
non-VSAM data sets. 


1. Control statements to dump and delete all movable single-volume non-VSAM 
data sets: 


DUMP INDD(DASD1) OUTDD(TAPE1) OPTIMIZE(3) - 
DATASET (BY ((DSORG,NE, VSAM) , (ALLOC,EQ,MCV) , (MULTI,EQ,NO))) - 
DELETE PURGE | 
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2. Control statements to defragment the volume: 


DEFRAG INDD(DASD1) 





3. Control statements to restore all dumped data sets: 





RESTORE INDD(TAPE1) OUTDD(DASD1) - 
DATASET (INCLUDE(**)) - 
CATALOG 






Consolidating Free Space on Volumes 


Because of the nature of allocation algorithms and the frequent creation, extension, 
and deletion of data sets, free space on DASD volumes becomes fragmented. This 


results in: 
¢ Inefficient use of DASD storage space 
e An increase in space-related abends (abnormal endings) 


¢ Performance degradation caused by excessive DASD arm movement 


c 


(DADSNf)-related func 


* An increase in the time required for direct access device space management 
c 


tions. 


By using the DEFRAG command. you can consolidate the free space on volumes 
and avoid this problem. The DEFRAG command relocates data set extents on a 


DASD voiume (including [BM 3330 virtual volumes) to reduce or eliminate 
free-space fragmentation. and prints a report about free space and other volume 


c 


statistics. Also. vou can specify which data sets. if any. are to be excluded from 


data-set-extent relocation. 


When to Run DEFRAG | 
Although the DEFRAG function can be run at any time on a volume, it does lock 
the VTOC (via RESERVE) and VVDS if it exists on the volume. The DEFRAG 
funetion alse serializes on data sets via ENQ or dynamic allocation. These activities 
Might cause excessive wait time for other jobs to update the VTOC. Therefore. 
times of low system activity are best for DEFRAG runs. 


Data Sets Excluded from DEFRAG Processing 


DFDSS dees not relocate the following types of data sets in a DEFRAG operation: 


User-specified data sets (EXCLUDE) 

Data sets that do not satisfy all BY criteria 

ISAM data sets 

VSAM data sets not cataloged in an integrated catalog facility catalog 
Key range VSAM data sets 

Catalogs (system, user. and CVOLs) 

The VTOC index data set 

Page. swap. and SYSI.STGINDEX data sets 

VSAM volume data sets (VVDS) 
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DEFRAG Options 


General Hints 


Serialization 


Unmovable data sets 
Data sets allocated by absolute track 
Data sets that it cannot serialize for exclusive access. 


Because DEFRAG does not relocate these data sets, the effectiveness of a DEFRAG 
run is affected by their presence. 


You can use the following keywords to make more efficient use of the DEFRAG 
command. 


DYNALLOC Use dynamic allocation, rather than enqueue, to serialize the use 
of data sets. This allows cross-system serialization in an 
MVS/JES3 environment. 


FRAGI(n) Perform a DEFRAG operation only if the fragmentation index is 
more than n. 


MAXMOVE(n) — Stop the defragmentation run when nv contiguous free tracks are 
assembled. If n contiguous free tracks already exist, ro 
defragmentation is performed. 


WATT(s.r) If the volume or data set is unavailaole. wait s seconds before 
retrying to obtain control of it and retry only r times. 


To determine the fragmentation index of a volume without actually performing the 
DEFRAG operation, code the NORUN parameter on the EXEC statement in your 
ICE: 


1. If vou want DEFRAG to perform in the shoriest period of time and/or create 
the largest single free space extent, you should perform the first pass only. This 
can be controlled by coding the MAXMOV Ett) ee arameter. using a very high 


‘alue (9999) for nm. When the value is higher than DEFRAG can assemble. the 
DEFRAG run stops at the end of the first pass. a: example: 


DEFRAG DYNAM I388002) MAXMOV Ei 9999) 


2. Experimenting with the DEFRAG FRAGI and MAXMOVE parameters will 
allow you to compare results when you operate on DASD with different 
fragmentation characteristics. The fragmentation index represents a number 
between 0 and | and can be one to three digits iong. (FRAGI(333) represents 
U.333 and FRAGI(3) represents 0.3. The recommended basic DEFRAG 
parameters are to let MAXMOVE default and use FRAGI(3). To DEFRAG 
DASD volume 388001. the following could be used: 


DEFRAG DYNAM(388001) FRAGI(3) 


The DEFRAG command serializes access to the VTOC by issuing a RESERVE on 
the VTOC. This serialization must be ended via the DEQ macro before generating 
the ending statistics provided by message ADR213I. Therefore. another job may 
allocate or delete data sets on the processed volume between the time the DEQ 
macro is issued and the ending statistics are obtained. See Data Facility Data Set 
Services: Reference for a description of the serialization scheme. 


DEFRAG also sertalizes access to each data set before relocating a data set’s extent. 
You will notice that LINKLIST data sets and other system data sets might remain 
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open but not enqueued. When defragmenting a volume with LINKLIST data sets, 
put them in the EXCLUDE list of DEFRAG to prevent them from being relocated. 


The enqueue scheme used by DEFRAG ensures integrity for data sets on a single 
processor but not for data sets on DASD shared between processors (due to the use 
of an ENQ scope of SYSTEM). To ensure the integrity of data sets on a shared 
DASD, you must do one of the following: : 


e Vary the volume offline from all processors except the one on which DEFRAG 
runs. After DEFRAG finishes, you can vary the volume back online for the 
other processors. 


For systems requiring continuous availability, this solution is not viable. The 
following solutions offer alternatives to varying volumes offline. 


¢ Use GRS or a GRS equivalent to convert the scope of all enqueues with a major 
name of SYSDSN from SYSTEM to SYSTEMS (place SYSDSN in the GRS 
SYSTEM Inclusion RNL). In addition, GRS must not be allowed to convert 
any of DEFRAG’s SYSTEMS enqueues to SYSTEM (GRS SYSTEMS 
Exclusion RNL), nor may it convert any of DEFRAG’s RESERVEs to simple 
enqueues (GRS RESERVE Conversion RNL). 


¢ If you are running on a system using JES3 with MDS enabled, you can use the 
DEFRAG keyword DYNALLOC to guarantee integrity for data sets on shared 
DASD. | 


You can ensure successful DEFRAG processing of volumes having a significant 
number of free or allocated extents by specifying appropriate SIZE and REGION 
parameters in the EXEC statement. If you receive a message that the region size is 
not large enough. specify a larger region size in the EXEC or JOB statement and 
rerun your job. 


Note: During DEFRAG processing, a Format 1 DSCB with the unique name 
“SYS1.DFDSS.DEFRAG. xxxxxxxx.volser. DUMMY” is used by DEFRAG to keep 
track of an extent when it is being relocated. This DSCB is not cataloged and 
automatically deleted after a successful run. If a job is cancelled or abnormally 
ends. this DSCB remains on the volume. After the restart. DADSM functions might 
fail with message IEC602. To correct this problem or to delete the 
“SYS1.DFDSS.DEFRAG.xxxxxxxx.volser. DUMMY” entry, rerun DEFRAG on the 
volume. 


Maximizing Track Utilization by Reblocking Data Sets 
DFDSS provides a REBLOCK kevword that allows users to maximize the track 
usage by data sets during COPY and RESTORE. When REBLOCK is specified on 
a fully- or partially-qualified name(s) of a SAM or PAM data set during COPY or 
RESTORE. DFDSS reblocks the specified data sets using a block size determined 
by: 


¢ A combination of the return code supplied by the installation reblock exit 
Routine (if there is any) and 


¢ The block size selected by DFDSS. 


106 DEFDSS: User’s Guide 


The following types of data sets are not eligible for reblocking: 


e PAM data sets with NOTELISTs 

¢ Load modules 

¢ SAM and PAM data sets with a variable spanned record format or with 
RECFM =U. 


~ 


DFDSS calculates the new block size to be used using either: (1) DASD Calculation 
Services if MVS/XA DFP Version 2 Release 2 or a later release is installed, or (2) by 
the reblocking scheme of DFDSS. This new block size is then passed to the 
installation reblock exit if the exit has not been disabled. DFDSS determines the 
target block size based on the return code set by the exit. 


If MVS/DFP Version 3 Release | or a later release is installed, the reblockable 
indicator (DS1REBLK) in the Format 1 DSCB also determines whether a data set is 
to be reblocked or not. When the indicator is on, the data set is always reblocked to 
the system-determined, optimal block size. A new return code has been added in the 
installation reblock exit routine to turn this indicator on when requested. 


See Chapter 5 of Data Facility Data Set Services: Reference guide for a more 
detailed description of the operations of the installation exit. 


Security Considerations 
For security purposes, the data set tracks used before the relocation are erased after 
relocation under these conditions: 


¢ RACF Version | Release 6 (or earlier release) is installed and either: 


The data set is RACF-protected, 
The VSAM data set has the ERASE attridute. 
The data set 1s password-protected. 


« When RACF Version | Release 7 and MVS XA DFP Version 2 Release | (or a 
later release) are installed and either: 


Tne data set was defined to RACF with the RACF ERASE option, 
The VSAM data set has the ERASE attribute, 


The data set is password-protected. (In this case, if the data set is also 
defined to RACF. the RACF ERASE option is taken. Figure 29 on 
page 108 provides more detail. 
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Password Defined RACF Erased on 
aa? el oo ie 


User Install Exit 
= ERASE 
(default) 
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Figure 29. Data Set Erase Table for DEFRAG (with RACF Version 1 Release 7) 











Note to Figure 29: 
The catalog entry contains the ERASE attribute specified when the data set was 
defined (VSAM only). 


You can prevent the tracks from being erased by using a user installation options. 
exit routine. See the UFOERASE field in the ADRUFO data area in Data Facility 
Data Set Services: Reference. 
DEFRAG does not relocate protected data sets unless: 

« You have RACF DASDVOL update access to the volume. 

¢ You have RACF DATASET read access to the data sets on the volume. 


« You specify the read or update password for password-protected data sets, or 
the authorization exit routine supplied with DFDSS is changed to allow 
relocation of protected data sets. 


When RACF DASDVOL class is active and a profile exists for the volume, a 


DASDVOL authorization failure causes the DEFRAG task to abend with a system 
code 913. This happens regardless of RACF data set access authority. 
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Appendix A. ACS Routine Variables 


This appendix lists the variables available to Automatic Class Selection (ACS) 
routines during DFDSS COPY, RESTORE, and CONVERTV. For details on 
writing ACS routines, see Storage Administration Reference. 


ACS Variables Available during COPY 


When Automatic Class Selection (ACS) is invoked during DFDSS COPY, the 
following variables are passed to the ACS routines: 


Variable Name 
&ACCT_JOB 
&ACCT_STEP 
&ALLVOL 


&ANYVOL 


&APPLIC 


&ACSENVIR 
&DD 
&DEF_DATACLAS 


&DEF_MGMTCLAS 


&DEF_STORCLAS 


&DSN 
&DSORG 
& DSOWNER 


&DSTYPE 
& EXPDT 
&GROUP 
&HLQ 
&JOB 


&LLQ 


&MAXSIZE 


&MSVGP 
&NQUAL 


Description 
Accounting information from the JOB statement. 


Accounting information on the EXEC statement. 


Output volume serial numbers. References the same volume 


list as XANYVOL, but, when used in a comparison, returns 
true only if all volume serial numbers satisfy the condition. 


Output volume serial numbers. References the same volume 
list as &ALLVOL, but, when used in a comparison, returns 
true if any volume serial numbers satisfy the condition. | 


Application identifier associated with the data set (available 
only if RACF is installed). 


Environment in which ACS was invoked. Set to 'ALLOC:! 
Ddname 


Default data ciass name (available only if RACF is 
installed). 


Default management class name (available onlv if RACF is 
installed). 


Default storage class name (available only if RACF is 
installed). 


Data set name. 
Data set organization. 


RACF owner or group that ts considered the data set owner 
(available only if RACF ts installed). 


Data set type (for example, GDS. PERM, or TEMP). 
Expiration date. 

Group identifier from the JOB statement. 

High-level qualifier of the data set name. 


Job name, started task name, or TSO user ID from the JOB 
statement. 


Low-level qualifier of the data set name. 


Maximum size of data set in kilobytes. For non- VSAM data 
sets, the primary value plus 15 extents. For VSAM data 
sets, the primary value plus 123 extents. 


Mass storage (MSS) volume names. 


Number of qualifiers in the data set name. 
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Variable Name 
&NVOL 
&PGM 
&RECORG 
&RETPD 
&SIZE 
&UNIT 
&USER 


&XMODE 


Description 


Number of output volumes specified by the user. 
Program name from the EXEC card. 

Data set record organization. 

Retention period. 

Size of the data set in kilobytes. 

Unit name. 


User ID from the JOB statement or the user ID propagated 
from the environment. 


Execution mode (for example, TSO, BATCH, or TASK). 


Figure 30. Variables Passed to ACS Routines during DFDSS COPY. 


Note: The following variables are not available to the storage group ACS routine: 
&ACCT_JOB, &ACCT_STEP, &DD, &JOB, &MSVGP, &PGM, and &XMODE. 


ACS Variables Available during RESTORE and CONVERTV 


When ACS is invoked during DFDSS RESTORE or CONVERTYV, the following 
variables are passed to the ACS routines: 


Variable Name 


&ALLVOL 


&ANYVOL 


& APPLIC 


&ACSENVIR 


&DEF_DATACLAS 


&DEF_MGMTCLAS 


&DEF_STORCLAS 


&DSN 
&DSORG 
& DSOWNER 


& DSTYPE 
&EXPDT 
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Description 


For RESTORE, the output volume serial numbers. For 
CONVERTYV. the volumes on which the data set resides. 
References the same volume list as XANYVOL. but, when 
used in a comparison, returns true only if all volume serial 
numbers satisfy the condition. 


For RESTORE, the output volume serial numbers. For 
CONVERTY, the volumes on which the data set resides. 
References the same volume list as &ALLVOL, but, when 
used in a comparison, returns true if any volume serial 
numbers satisfy the condition. 


Application identifier associated with the data set (available 
only if RACF its installed). 


Environment in which ACS was invoked. Set to 
'RECOVER' for RESTORE. Set to 'CONVERTV' for 
CONVERTYV. 


Default data class name (available only if RACF is 
installed}. 


Default management class name (available only if RACF its 
installed). 


Default storage class name (available only if RACF 1s 
installed). 


Data set name. 
Data set organization. 


RACF owner or group that is considered the data set owner 
(available only if RACF is installed). 


Data set type (for example, GDS, PERM, or TEMP). 


Expiration date. 


Variable Name Description 


&HLQ High-level qualifier of the data set name. 
&LLQ Low-level qualifier of the data set name. 
&MAXSIZE Maximum size of data set in kilobytes. For non-VSAM data 


sets, the primary value plus 15 extents. For VSAM data 
sets, the primary value plus 123 extents. 


&NQUAL Number of qualifiers in the data set name. 
&NVOL For RESTORE, number of volumes specified by the user. 


For CONVERTYV, the number of volumes (including 
candidate volumes) on which the data set resides. 


&RECORG Data set record organization. 

&RETPD Retention period. 

&SIZE Size of data set in kilobytes. 

&UNIT Unit name. 

Figure 31. Variables Passed to ACS Routines during DF DSS RESTORE and 
CONVERTV. 
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Appendix B. Changing Command Specifications for DFDSS 
Version 2 Release 4 


The following sections briefly explain what the new keywords were for Version 2 
Release 4 and how they affect DFDSS processing. 


Volume Specification 


Cataloging 


Because the system places data sets in an SMS environment, you need not know on 
what volume a particular data set resides. As a result, when you move data sets 
within an SMS environment, you should avoid specifying output volumes. You 
should specify commands without OUTDD and OUTDYNAM. For example: 





| 
| COPY - 
DATASET(INCLUDE(**))  - 
LOGINDYNAM( (338001) ,(338002)) - 
DELETE 





You can specify output volumes in an SMS environment, but, depending upon how 
your ACS routines are written, the volume serial numbers you specify might or 
might not be used to determine where the data is placed. 


Only data sets with the guaranteed space attribute in their storage class are 
zuaranteed to go on a volume you specify. However, the volumes you specifv must 
all be SMS volumes in the same storage group. ACS must assign to the data set(s) 
the storage group that contains all the volumes. If these conditions are not met, the 
allocation of the data set fails. 


In an SMS environment, all data sets must be cataloged. You cannot use JOBCAT 
and STEPCAT. To find data sets outside the standard order of search with DFDSS, 
vou must use the INCAT keyword and specify the catalog name as in the following 
example: . 


—_ 


DUMP - 
DATASET(INCLUDE(**))  - 
INCAT(SYS1.PAYROLL.ICFCAT, PAYROLL.ADMIN.ICFCAT) - 
DELETE - 
COMPRESS 








In addition, because SMS-managed data sets must be cataloged in the standard 
order of search, the RECATALOG keyword ts ignored for these data sets. 
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JCL Changes 





The main change to the job control language (JCL) is that JOBCAT and STEPCAT 
are prohibited in an SMS environment. Therefore, to find data sets cataloged 
outside the standard order of search. you must use the DFDSS INCAT keyword. 


Processing VSAM Spheres 


If you want to process an entire VSAM sphere with COPY, DUMP, or RESTORE, 
you should use the SPHERE keyword. This keyword causes DFDSS to COPY, 
DUMP, or RESTORE the base cluster and all associated alternate index clusters 
and paths of a VSAM data set. For instance, if you want to restore a VSAM 
sphere, code the RESTORE command as shown in the following example. 


Note: You can RESTORE an entire VSAM sphere only if the input volume was 
also dumped using the SPHERE keyword. 





RESTORE - 
DATASET (INCLUDE (T01729.ACCOUNTS.JAN88)) - 
INDD(TAPE1)  - 
SPHERE 


All parts of a target sphere must be directed through the standard order of search to 
the same catalog. This includes the base cluster, all of its related AIXs, and all of its 
paths. 


DFDSS normally processes data sets on an individual basis. Use of the SPHERE 
keyword. however, causes DFDSS to consider a VSAM SPHERE as a collection of 
individual data sets and associated catalog information. 


Although DFDSS will consider the sphere as one entity for movement purposes, 
other keywords will still operate on the individual components of the sphere. The 
most important example of this is the RENAME and RENAMEU keywords. 


To rename all of a SPHERE, you must either rename each of the individual sphere 
components. or if all of your sphere components start with the same high level 
qualifier. vou can rename by specifying a new high level prefix for the sphere. 


Considerations for Processing VSAM Spheres 
There are certain restrictions to bear in mind when processing VSAM spheres with 
COPY. DUMP, or RESTORE. 


Restrictions for COPY 

¢ The copying of a sphere is permitted only if all parts of the sphere resolve to the 
same catalog. 

¢ To logically COPY a sphere without the DELETE or RECAT keyword. vou 
must rename every data set in the sphere. This includes all paths. all AINs. and 
the base cluster. If the target sphere is to be SMS managed. the data sets must 
be renamed even if RECATALOG 1s specified because RECATALOG is ignored 
for SMS-managed data sets. 


114. DEDSS: User’s Guide 


e When copying with DELETE between SMS and non-SMS environments or 
| between different storage groups in SMS, you must include all parts of the 
| sphere. You can do this by specifying SPHERE and naming the base cluster. 


Restrictions for RESTORE 
¢ You can restore a sphere only if all parts of the sphere resolve to the same 
catalog. 


¢ Unlike the COPY function, you may not need to rename all of the parts in the 
VSAM sphere as you would with COPY. 


e When restoring a sphere that has one or more AIXs missing from the dump 
tape, DFDSS issues a message to indicate that the sphere was incompletely 
restored. 


Restrictions for DUMP 
You should be aware that you cannot restore a sphere unless it is dumped as a 
sphere with the SPHERE keyword. 


Reblocking Data Sets with RESTORE | 


You can reblock one or more of the data sets you are restcring by specifying the 
REBLOCK keyword with the RESTORE command. REBLOCK processing for 
RESTORE operates in the same way as it does for the COPY command. 
Reblocking is done only if the new block size is more efficient than the existing one. 


The following RESTORE job stream reblocks data set T01729.ACCOUNTS.JAN88 
(if the new block size is more efficient than the existing one): 


BN a Sa 
| RESTORE - | 
DATASET (INCLUDE(*. ACCOUNTS. JAN88) ) - | 
INDD(TAPEL)  - | 
REBLOCK (101729. ACCOUNTS. JAN88) | 





Note: If PAM data sets are specified with both REBLOCK and NOPACKING 
keywords. the data set will not be reblocked. 
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Appendix C. Stand-Alone Restore Program 


This chapter describes the hardware and software requirements for DFDSS and 
stand-alone DFDSS restore. 


Stand-alone DFDSS restore must operate in engineering change (EC) mode. 


Storage Devices 
You can use stand-alone DFDSS restore with the following IBM direct access 
storage devices: 


Direct access storage 2305 Fixed Head Storage Model 2 
devices: 3330 Disk Storage Models | and 11 
3340 Direct Access Storage Facility 
3344 Direct Access Storage 
3350 Direct Access Storage (in native mode and in 
3330 Models | and 11 compatibility mode) 
3375 Direct Access Storage 
3380 Direct Access Storage (all models) 
3330 Virtual volumes residing in a 3850 Mass 
Storage System 


Tape devices: 2400 series Magnetic Tape Units 
3420 series Magnetic Tape Units 
3430 Magnetic Tape Unit 
3480 Magnetic Tape Subsystem (a!l modeis) 


Other Devices 
You can use stand-alone DFDSS restore with the following IBM devices: 


System consoles: 1052 Printer-Keyboard Model 7 
3036 Console 
3056 Remote System Console 
3138 Processing Unit Console 
3148 Processing Unit Console 
3158 Processing Unit Display Console Keyboard 
3210 Console Printer-Keyvboard Models | and 2 
3215 Console Printer-Keyvboard Model | 
3270 Information Display System 
3277 Display Station Model 2 
3278 Display Station Model 2A 


Printers: 1403 Printer 
1443 Printer 
3203 Printer 
3211 Printer 
3262 Line Printer Model 5 
3800 Printing Subsystem 
4245 Printer 
4248 Printer 
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Card readers: 2501 Card Reader 


2520 Card Read Punch 
2540 Card Read Punch 
3505 Card Reader 


You can use the appropriate generic name (CNSL, PRNT, CARD, or TAPE) to 
access these devices. 


Restrictions 


The following restrictions apply to stand-alone DFDSS restore: 
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Stand-alone DFDSS restore can restore from tape volumes created by full or 
tracks DUMP, or it can restore a track or tracks from the first logical volume of 
a physical data set DUMP. It cannot restore from tapes created by a logical 
DUMP operation. 


DASD volumes that are to be restored must be initialized. 


Stand-alone DFDSS restore can only restor¢ from the first physical tape file of 
tape volumes. 


There must be a match between the device type of the source volume used in a 
(system DFDSS) DUMP and the device type of the receiving volume used in a 
stand-alone DFDSS restore. However, you can do the following: 


— Dump data from an IBM 3330 Model 1 can be restore to an IBM 3330 
Mode 


— Dump data from an IBM 3340 with 35-megabyte capacity can be restored 
an IBM 3340 with 70-megabyte capacity or to an IBM 3344. 


— Dump data from a smaller capacity IBM 3380 model can be restored to a 
larger capacity IBM 3380 model. 


Note: When you restore data from a smaller device to a larger device. the 
freespace information becomes invalid. The freespace information in the 
VTOC is rebuilt when vou allocate a data set on the volume. 


The following system consoles are not supported by stand-alone DFDSS restore: 


— System/370 Model 115/125 Operator Console 
— IBM 3066 System Console (System/370 Mode! 168) 


Stand-alone DFDSS restore has no function other than restore. 
Stand-alone restore requires exclusive controi of all input. output devices. 


Stand-alone restore in System/370 extended-architecture mode requires your 
source tape on a different tape drive than the IPL device. 


Neither mass storage virtual volumes nor minivolumes can be restored. 


Stand-alone DFDSS restore cannot restore from dump tapes produced by other 
utilities. 

Stand-alone DFDSS restore can only restore from the first logical volume of a 
dump tape produced from multiple source volumes. 


i207 


The devices used to do a stand-alone restore in System/370 mode must be 
attached to the processor you are restoring (where there are two or more 
processors). 


nalts es Set 
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, Compatibility with DFDSS 


| Stand-alone DFDSS restore can restore any physical full-volume dump made by 
| DFDSS as long as the physical dump is the first data set on the tape volume. 
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Glossary of Terms and Abbreviations 


This glossary includes definitions of some terms found 
in this document. Some of the terms defined below are 
from: 


¢ The American National Dictionary for Information 
Processing Systems, copyright 1982 by the 
Computer and Business Equipment Manufacturers 
Association. Copies may be purchased from the 
American National Standards Institute at 1430 
Broadway, New York, New York 10018. These 
definitions are identified by an asterisk (*). 


¢ The JSO Vocabulary - Information Processing, and 
the JSO Vocabulary - Office Machines, developed by 
the International Standards Organization, Technical 
Committee 97, Subcommittee 1. Definitions from 
published sections of this vocabulary are identified 
by the symbol “(ISO)” preceding the definition. 
Definitions from draft proposals and working 
papers under development by the [SO/TC97 
vocabulary subcommittee are identified by the 
symbol “(TC97),” indicating that final agreement 
has not yet been reached among its participating 
members. 


A 


ABEND. Abnormal end of task. End ofa task, a Job. 
or a subsvstem because of an error condition that 
cannot be resolved Dy recovery facilities while the task is 
periornmned, 


ABENDxxx. The kevword that identifies the abnormal 
end of DFDSS because of a system-detected error. 


ABSTR. A subparameter of the SPACE parameter in a 
DD statement. It indicates that specified tracks be 
assigned to a data set. 


ACCEPT processing. An SMP.E process necessary for 
installing the FMIDs. SMP E ACCEPT processing uses 
JCL to accept the modules and macros necessary to run 
the FMIDs. The FMIDs ure accepted into the DLIBs 
from the temporary data sets. 


Access method services. A multifunction service 
program that is used to manage both VSAM and 
non-VSAM data sets and integrated catalog facility or 
VSAM catalogs. I[t is used to define data sets and 
allocate space for them. convert indexed-sequential data 
sets to kev-sequenced data sets. modify data set 
attributes tn the catalog. reorganize data sets. facilitate 
data portability between operating svstems, create 
backup copies of data sets. data set records and catalog 


entries. help make inaccessible data sets accessible, list 
the records of data sets and catalogs, define and build 
alternate indexes, and convert OS CVOLs and VSAM 
catalogs to integrated catalog facility catalogs. 


ACDS. Active control data set. 
ACS. Automatic class selection. 
AIX. Alternate index. 


alias. An alternate name for a member of a partitioned 
data set. 


ALLOC. A space allocation parameter that indicates 
type, such as cylinders or tracks. 


alternate index (AIX). In systems with VSAM, a 
key-sequenced data set containing index entries 
organized by the alternate keys of its associated base 
data records. It provides an alternate means of locating 
records in the data component of a cluster on which the 
alternate index is based. 


alternate index cluster. In VSAM, the data and index 
components of an alternate index. 


APAR. Authorized Program Analysis Report. 


Authorized Program Analysis Report (APAR). A 
request for correction of a problem caused by a 
suspected defect in a current unaltered release of a 
program. 


APF. Authorized program facility. 


Application Interface. An interface used to invoke 
DFDSS from another program. 


Apply processing. In SMP and SMP’E, the process, 
initiated by the APPLY command. that places system 
modifications (SYSMODS) into the target system 
libraries. 


attach. In programming, to create a task that can be 
performed asynchronously with the performance of the 
mainline code. 


authorization. (1) (TC97) The right granted to a user to 
communicate with or make use of a computer system. 
(2) The process of giving a user either complete or 
restricted access to an object, resource, or function. 


automatic class selection (ACS). A mechanism for 
assigning SMS classes and storage groups. 
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base cluster. In systems with VSAM, a key-sequenced 
or entry-sequenced data set over which one or more 
alternate indexes are built. 


basic catalog structure (BCS). The name of the catalog 
structure in the integrated catalog facility environment. 
An integrated catalog facility catalog consists of a BCS 
and its related VSAM volume data sets (VVDSs). 


basic direct access method (BDAM). An access method 
used to directly retrieve or update particular blocks of a 
data set on a direct access device. 


basic partitioned access method (BPAMI). An access 
method that can be applied to create program libraries 
in direct access storage for convenient storage and 
retrieval of programs. 


basic sequential access method (BSAM)}. An access 
method for storing or retrieving data blocks ina 
continuous Sequence, using either a sequential access or 
a direct access device. 


BCS. Basic catalog structure. 

BDAML. Basic direct access method. 

BLK. A subparameter of the SPACE parameter ina 
DD statement. It specifies that space :s allocated by 
blocks. 

block length. Synonym for block size. 

block size. (1) (TC97) The number of data elements in 
a block. (2) * A measure of the size of a block, usuallv 
specified in units such as records, words. computer 
words. or characters. (3) Synonymous with block 
length. 

BPAMI. Basic partitioned access method. 


bpi. bits per inch. 


BSAYL. Basic sequential access method. 


C 


call. (ISO) * The action of bringing a computer 
program, a routine. or a subroutine into effect, usually 
by specitving the entry conditions and tumping to an 
entry point. 


card image. * A one-to-one representation of the hole 
patterns of a punched card: for example. a matrix in 
which a one represents a punch and a zero represents 
the absence of a punch. 
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CCHHR. Cylinder, cylinder, head, head, record. 
CCW. Channel command word. 

CDE. Contents directory entry. 

CDS. Control data set. 

channel command word (CCW). A doubleword at the 
location in main storage specified by the channel 
address word. One or more CCWs make up the channel 
program that directs data channel operations. 

CI. Control interval. 

CLIST. Command list. 

component identification keyword. The first keyword, 
represented as a number, in a set of keywords used to 


describe a DFDSS program failure. 


COMPRESS command. The DFDSS function that 


‘ reduces partitioned data sets by taking unused space and 


consolidating it at the end of the data set. 


concatenation. An operation that joins two characters 
or strings in the order specified, forming one string 
whose length is equal to the sum of the lengths of the 
two characters or strings. 


control interval (CD). A fixed-length area of auxiliary 
storage space in which VSAM stores records. It is the 


unit of information transmitted to or from auxiliary file. 
storage by VSAM. 


control volume (CVOL). A volume that contains one or 
more indexes of the catalog. 


constructs. A collective name for data class, storage 
class, management class, and storage group. 


CONVERTY command. The DFDSS function that 
converts volumes to and from Storage Management 


Subsystem management without data movement. 


COPY command. The DFDSS function that performs 
data sets. volumes, and tracks movement. 


CREDT. Creation date. 

CSW. Channel status word. 

CVAF. Common VTOC access facility. 

CVOL. Control volume. 

CVT. Communication vector table. 

CYL. A subparameter of the SPACE parameter in a 


DD statement. It specifies that space is allocated by 
cylinders. 


D 


DADSM. The direct access space management 
program that maintains the VTOC, VTOCIX, and space 
on a volume. 


DAM. Direct access method. 
DASD. Direct access storage device. 
DASD ERP. DASD error recovery procedure. 


data class. A list of data set allocation parameters and 
their values that are used when allocating a new 
SMS-managed data set. 


data compression (run-length). A method of encoding 
repetitive series of identical characters so that they 
occupy less space on a dump tape. Data compression is 
supported by both physical dump and logical dump 
processing. . 


Data Facility Data Set Services (DFDSS). A DASD 
data and space management tool for backup and _ 
recovery, space management functions. and copying 
data between like and unlike devices. DFDSS is the 
primary data mover of the Data Facility family. 


Data Facility family. A family of products, consisting 
of DFP, DFDSS. DF HSM. and DFSORT, that 


Data Facility Hierarchical Storage Manager (DFHSMJ). 
A facility that automates space and availability 
management bv Dacxing up and migrating data within a 
hierarchy of storage. 


Data Facility Product (DFP). The key architectural 
component of the Storage Management and 
non-Storage Management Subsystem environments. 
DFP manages programs, data, and devices in the MVS 
environment. 


Data Facility Sort i(DFSORT). A data and storage 
management tool taat handles sorting. merging, and 
copying applications. 


Data Facility Storage \lanagement Subsystem 
(DFSMS). The complementary functions of MVS/DFP 
and other individua: products of the Data Facility 
family, which, together with RACF provide a 
system-managed. acministrator-controlled storage 
environment. 


data set backup. Backup to protect against the loss of 
individual data sets. 


data set change indicator. Bit 6 of the DSIDSIND field 
in the Format | DSCB. It is set by OPEN when the 
data set is opened for processing other than input. This 


flag is supported on MVS systems that have 
data-set-changed flag support installed. 


DAU. Direct access unmovable. 
DB2. IBM DATABASE 2. 
DCB. Data control block. 


DEFRAG command. The DFDSS function that 
consolidates the free space on a volume to help prevent 
out-of-space abends on new allocations. 


DEQ. An Assembler language macro instruction used 
to remove control of one or more serially reusable 
resources from the active task. 


DFDSS. Data Facility Data Set Services. 


DFHSM. Data Facility Hierarchical Storage Manager. 


DFP. Data Facility Product. 


DFSMS. Data Facility Storage Management 
Subsystem 


DFSORT. Data Facility Sort. 


DGTHIXS50. The panel identification number for the 
DFDSS Help Index. It is used to verify that 
DFDSS ISMF is installed correctly. 


DIAGNOSE. An access method services command that 
scans an integrated cataiog facility basic catalog 
structure (BCS) or a VVDS to validate the data 
structure, 


DIRF. DADSM interrupt recording facility. Ifa 
svstem fails. or a permanent [/O error occurs during 
allocation of space or during performance of a routine 
that updates the VTOC, the VTOC may be in error. To 
ensure that an error is recorded, the DADSM routines 
turn on a bit in the VTOC upon entrv to a DADSM 
function. and, if no errors occur during processing, turn 
off that bit upon exiting from that function. This DIRF 
bit is bit 5 of the DS4+VTOCI field of the Format 4 
DSCB. 


distribution libraries. [BM-supplied partitioned data 
sets on tape containing one or more components that 
the user restores to disk for subsequent inclusion in a 
new system. 


DLIB. Distribution library. 
BOC. In diagnosing program failures. the keyword 
that identifies an error in the documentation of a 


program. 


DOS. Disk Operating System. 
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DOS bit. On a volume without an indexed VTOC a bit 
that indicates that the free space map (Format 5 DSCB) 
is invalid. 


DOS/VSE. DOS/Virtual Storage Extended. 
DSCB. Data set control block. 

DSCHA. Data-set-changed flag 

dsn. Data set name 


DSORG. Data set organization. It is specified in the 
JCL as “DSORG =.” It is indicated in a field in the 
Format | DSCB control block in the VTOC. 


DSILSTAR. A field in the Format 1 DSCB in the 
VTOC that indicates the last-used track and last block 
on that track, in the form of a relative track and record 
number (TTR). 


DUMP command. The DFDSS function used to back 
up data sets, tracks. and volumes. 


dynamic allocation. Assignment of system resources to 
a program when the program is performed rather than 
when it is loaded main storage. 


E 


Early Warning System (EWS). A microfiche copy of 
the information contained in the Software Support 
Facility (SSF), organized by component identification 
number and indexed by APAR symptom code. EWS is 
published monthly and available to customers of IBM 
licensed programs. 


ECB. Event control block. 
EC mode. Engineering change mode. 


ENQ. An Assembler language macro instruction that 
requests the control program to assign control of one or 
more serially reusable resources to the active task. It is 
also used to determine the status of a resource; that is, 
whether it is immediately available or in use. and 
whether control has been previously requested for the 
active task in another ENQ macro instruction. 


entry-sequenced data set (ESDS). In VSAM. a data set 
whose records are loaded without respect to their 
contents and whose RBAs cannot change. Records are 
retrieved and stored by addressed access, and new 
records are added at the end of the data set. 

EOF. End-of-file. 

EOJ. End of job. 


ESDS. Entry-sequenced data set. 
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ESTAE. Extended specify task abnormal exit. 
EQ. Equal to. 

EWS. Early Warning System. 

EXCP. Execute channel program. 


Execute channel program (EXCP). A macro used to 
access a data set without specifying the organization. 


EXPDT. Expiration date. 


Extended specify task abnormal exit (ESTAE). A task 
recovery routine that provides recovery for those 
programs that run enabled, unlocked, and in task mode. 


extent. A continuous space on a DASD volume 
occupied by a data set or portion of a data set. An 
extent of a data set contains a whole number of control 
areas. 


7 


FC. CVAF function code. 
FCEC. CVAF function-error code. 


filtering. The process of selecting data sets based on 
specified criteria. These criteria consist of fullv- or 
partially-qualified data set names and/or of certain data 
set characteristics. 


FMID. Function modification identifier. 


Format 1 DSCB (F1 DSCB). An identifier DSCB that 
describes a data set or VSAM data space and its first 
three extents. See the appropriate system data areas 
manual. 


Format 2 DSCB (F2 DSCB). An index DSCB that 
describes the indexes of an ISAM data set. See the 
appropriate system data areas manual. 


Format 3 DSCB (F3 DSCB). An extension DSCB that 
describes the 4th through 16th extents of a data set or 
VSAM data space. See the appropriate system data 
areas manual. 


Format 4 DSCB (F4 DSCB). A VTOC DSCB that 
describes the extent and contents of the VTOC and 
volume and device characteristics. See the appropriate 
system data areas manual. 


Format 5 DSCB (F5 DSCB). A free space DSCB that 
describes the space on a volume that has not been 
allocated to a data set or to a VSAM data space 
(available space). See the appropriate system data areas 
manual. 


fully-qualified data set name. A data set in which all the 
qualifiers are completely spelled out. 


function modification identifier (FMID). A code that 
identifies the release levels of a program product. 


FVL. function vector list. 


G 


GDG. Generation data group. 
GDS. Generation data set. 


Generation data group (GDG). A collection of 
historically related non- VSAM data sets that are 
arranged tn chronological order; each data set is a 
generation data set. 


Generation data set. , One generation of a generation 
data group. , 


GT. Greater than. 


ICKDSF. Device Support Facilities. 
IDCAMS. Access Vfethod Services. 


IMS/VS. Information Management System/ Virtual 
Storage. 


INCORROLT. In diagnosing program failures, the 
keyword that identifies incorrect or missing program 
output. 


incremental backup. A process in which data sets are 
backed up only if they have changed since their last 
backup. 


integrated catalog facility. A facility by which VSAM 
data set volume-related fields are separated from the 
catalog and maintained in the VVDS on the volume on 
which the data set resides. 


Interactive Storage Vlanagement Facility (ISMF). A 
DFP component that provides an interactive interface to 
DFDSS and DFHSM. ISMF uses menu-driven panels 
to build jobs streams for most DFDSS functions. 
DFDSS-ISMF pertorms the following functions: 
COMPRESS, CONVERTY. COPY, DEFRAG, DUMP, 
RELEASE, and RESTORE. 


Interactive System Productivity Facility ISPF). An 
IBM licensed program used to develop, test, and run 
appheation programs interactively. ISPF is the 
interactive interface for all storage management 
functions. 


1/O. Input/output. 

IPL. Initial program load. 

ISMF. Interactive Storage Management Facility. 
ISAM. Indexed sequential access method. 
ISMF. Interactive Storage Management Facility. 
ISPF. Interactive Systems Productivity Facility. 


ISPF/PDF. Interactive Systems Productivity 
Facility/Program Development Facility. 


J 


JCL. Job control language. 
JES. Job entry subsystem. 
JES2. An MVS subsystem that receives jobs into the 


system, converts them to internal format. selects them 
for operation, processes their output, and purges them 


‘from the system. In an installation site with more than 


one processor, each JES2 processor independently 
controls its job input, scheduling, and output processing. 


JES3. An MVS subsystem that receives jobs into the 
system, converts them to internal format, selects them 
for operation, processes their output. and purges them 
from the system. In complexes that have several 
loosely-coupied processing units, the JES3 program 
manages processors so that the global processor 
exercises centralized control over the local processors 
and distributes jobs to them via a common job queue. 


JFCB. Job file contro! block. 


job control language (JCL). A problem-oriented 
language used to identify the job or describe its 
requirements to an operating system. 


job entry subsystem (JES). A system facility for 
spooling, job queuing. and managing I O. 


JSCB. Job step control block. 


K 


key-sequenced data set. A VSAM file or data set whose 
records are loaded in ascending key sequence and 
controlled by an index. Records are retrieved and 
stored by keyed access or by addressed access, and new 
records are inserted in key sequence by means of 
distributed free space. Relative byte addresses can 
change because of control interval or control area splits. 


keyword. A symptom that describes one aspect of a 
program failure. 
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KSDS. Key-sequenced data set. 


L 


LASTCC. Last condition code. 
LDS. Linear data set. 


like devices. Devices that have the same track capacity 
and number of tracks per cylinder (for example, 3380 
Standard and 3380 Model J or K). 


LINK. An Assembler language macro instruction that 
causes control to be passed to a specified entry point. 
The linkage relationship established is the same as that 
created by a BAL instruction. 


link-pack area (LPA). An area of virtual storage that 
contains re-enterable routines that are loaded at IPL 
(initial program load) time and can be used concurrently 
by all tasks in the system. - 


load module. (TC97) A computer program in a form 
suitable for loading into main storage for operation. 


load module library. A partitioned data set used to . 
store and retrieve load modules. . 


logical (data set) DUMP operation. A DUMP 
operation in which logical processing is performed. 


logical (data set) processing. Processing that treats each 
data set and its associated information as a logical 
entitv. As an example. DFDSS processes an entire data 
set before beginning with the next one. 


logical (data set} RESTORE operation. A RESTORE 
operation that uses as input a data set produced by a 
logical DUMP operation. 


logical volume. The output produced from a physical 
DUMP operation. for which all data is derived from a 
single DASD volume. 

LOOP. [n diagnosing program failures. the keyword 
that identifies a program failure in which some part of 
the program repeats endlessly. 

LPA. link-pack area. 

LT. Less than 

LRECL. Logical record length. 


» 


LVOL. logical volume. 
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maintenance-level keyword. In diagnosing program 
failures, a keyword that identifies the maintenance level 
of DFDSS. 

management class. A list of the migration, backup and 
retention parameters and their values for an 
SMS-managed data set. 


map record. The record that maps the tracks that were 
dumped by DFDSS. 


MAXCC. Maximum condition code. 

MCS. Multiple Console Support. 

MENTITY. Model entity. 

minivolume. In an MVS system running on VM/370, an 
OS/VS-formatted VM/370 minidisk whose size is equal 
to or less than that of the real volume. DFDSS uses the 
device size specified in the Format 4 DSCB in their 
VTOC. Minivolumes are supported only by the system 
version of DFDSS. 

MSGADRont.. In diagnosing program failures, the 
DFDSS message keyword that tells of an error, or 
seems itself to be in error. 


MSS. Mass storage system. 


MVS. Multiple virtual storage. 


N 


NYR. Non-VSAM volume record. 


O 


Operating System (OS). Software that controls the 
execution of programs: an operating system may 
provide services such resource allocation, scheduling, 
input/output control, and data management. 


OS. Operating System. 


OS/VS2. Operating System/Virtual Storage 2. . 


Pp 


pageable link-pack area (PLPA). Link-pack area. 
PAM. Partitioned access method. 


partially-qualified data set name. A data set name in 
which the qualifiers are not spelled out. Asterisks and 


percent signs are used in place of the undefined 
qualifier(s). 


partitioned data set (PDS). A data set in direct access 
storage that is divided into partitions, called members, 
each of which can contain a program, part of a 
program, or data. 


partitioned data set extended (PDSE). A 
SMS-managed, page-formatted data set on direct access 
storage. A PDSE contains an indexed directory and 
members similar to the directory and members of 
partitioned data sets. A PDSE can be used instead of a 
partitioned data set. 


PDS. Partitioned data set. 
PDSE. Partitioned data set extended. 


PERFM. In diagnosing program failures, the keyword 
that identifies degradation in program performance... 


physical (data set) DUMP operation. A DUMP 
Operation in which physical processing is performed. 


physical (data set) processing. Processing that moves 
data at the track-image level and can operate against 
volumes, tracks. and data sets. As an example, DFDSS 


may only process one volume of a multivolume data set. 


PLPA. Pageabie link-pack area. 
POUL. Partitioned organization unmovable. 
PRB. Program request olock. 


private library. A user-owned library that is separate 
and distinct from the svstem librarv. 


PSU. Physical sequential unmovable. 
PSW. Program status word. 


PTF. Program temporary fix. 


Q 


QSAM. Queued sequential access method. 


qualified name. A data set name consisting of a string 
of names separated by periods; for example, 
“TREE.FRUIT.APPLE” ts a qualified name. 


qualifier. Each component name in a qualified name 
other than the rightmost name. For example, “TREE” 
and “FRUIT™ are qualifiers in 
“TREE.FRUIT.APPLE.” 


Queued sequential access method (QSAM). An 
extended version of the basic sequential access method 


ee 
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(BSAM). Input data blocks awaiting processing or 
output data blocks awaiting transfer to auxiliary storage 
are queued on the system to minimize delays in I/O 
operations. 


R 


RACF. Resource Neves Control Facility. 
RB. Request block. 

RBA. Relative byte address. 

RDJFCB. Read job file control block. 


RECEIVE processing. An SMP/E process necessary to 
install new product libraries. During this process, the 
code, organized as unloaded partition data sets, is 
loaded into temporary SMPTLIB data sets. SMP/E 
RECEIVE processing automatically allocates the 
temporary partitioned data sets that correspond to the 
files on the tape, and loads them from the tape. 


RECFM. Record format. 
REFDT. Last-referenced date. 


relative byte address (RBA). The displacement 
(expressed as a fullword binary integer) of a data record 
or a control interva! from the beginning of the data set 
to whica it belongs. independent of the manner in which 
the data set is stored. 


Relative record data set (RRDS). A VSAM data set 
whose records are loaded into fixed-length slots. 


RELEASE command. The DFDSS function that 
releases the unused space in sequential and partitioned 
data sets for use bv other data sets. 


RESERVE. A method of serializing DADSM update 
accesses to the VTOC. It is also a method of serializing 
processor accesses to a shared DASD volume. 


Resource Access Control Facility (RACF). An IBM 
program product that provides for access control by 
identifying and verifving users to the system, 
authorizing access to DASD data sets, logging the 
detected unauthorized attempts to enter the system, and 
logging the detected accesses to protected data sets. 


RESTORE command. The DFDSS function used to 
recover data sets, tracks. and volumes. 


RMID. Replacement module identifier. 
RRDS. Relative record data set. 


run-length data compression. Data compression 
(run-length). 
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SAF. System Authorization Facility. 


SAM. Sequential access method. 


scheduler task. A DFDSS subtask that interprets and 
schedules commands. 


SCP. System control program. 
SEQ. Sequential or sequential processing 


SEREP. System environmental recording, editing, and 
printing 


SMF. System management facilities. 
SMP. System Modification Program. 
SMP/E. System Modification Program/Extended. 


SMPE. A cataloged procedure that includes the 
required DD statements for running SMP/E and is used 
in the RECEIVE, APPLY, and ACCEPT steps of 
SMPYE processing. 


SMS. Storage Management Subsystem. 


Software Support Facility (SSF). An IBM online data 
base that allows for storage and retrieval of information 
about all current APARs and PTFs. 


SP. System Product. 


sphere. A VSAM cluster with one or more associated 
alternate indexes and paths. The VSAM cluster 
(sometimes cailed the base cluster), alternate indexes 
(AIXs). and paths are sometimes referred to as sphere 
components. 


SSF. Software Support Facility. 


stand-alone DFDSS restore program. One of two 
DFDSS programs. Stand-alone DFDSS restore runs 
independently of the MVS svstem environment and Is 
limited to one function—a full or partial (tracks) 
RESTORE trom a dump tape. 


storage class. A named list of data set storage 
attributes that SMS uses to identify pertormance and 
availability requirements. 


storage constructs. The group of predefined models 
(data class. management class. storage class, and storage 
group) that are used to classifv storage management 
needs and procedures for data sets under the Storage 
Management Subsystem. Each data set has construct 
names associated with it by explicit specification or 
defaulting. 
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storage group. A named collection of DASD volumes 
that have been grouped to meet a defined service 
strategy. 


storage management. The task of managing auxiliary 
storage resources for an installation. 


Storage Management Subsystem (SMS). An MVS 
subsystem that helps automate and centralize the 
management of storage. To manage storage, the 
storage management subsystem provides the storage 
administrator with control over data class, storage class, 
management class, storage group, and automatic class 
selection routine definitions. 


subtask. A task initiated and ended by a higher order 
task. 


SVC. Supervisor call instruction. 
SVRB. Supervisor request block. 
SYSRES. System residence disk. 


system library. A collection of data sets or files in 
which the parts of an operating system are stored. 


system link library. System library. 


System Modification Program (SMP). A program used 
to install software and software changes on the MVS 
system. 


System Modification Program Extended (SMP/E). An 
IBM licensed program used to install software and 
software changes on the MVS system. In addition to 
providing the services of SMP, SMP’E consolidates 
installation data, allows more flexibility in selecting 
changes to be installed. provides a dialog interface, and 
supports dynamic allocation of data sets. 


TCB. Task control block. 


Time sharing option (TSO). An option on the operating 


system for a System 370 that provides interactive time 
sharing from remote terminals. 


TIOT. Task input output table. 

TLIBs. Target data sets. 

track packing. A technique used by DFDSS that builds 
target tracks for any DASD device using input physical 
record information. 

TRK. A subparameter of the SPACE parameter in a 


DD statement. It specifies that space is to be allocated 
by tracks. 


TSO. Time-sharing option. 

TSO/E. TSO/Extensions. 

TTR. track-track-record. 

type-of-failure keyword. In diagnosing program failures, 


a keyword that identifies the type of program failure 
that has occurred in DFDSS. 


U 


UACC. Universal access authority. 
UCB. Unit control block. 
UIM. User interaction module. 


unlike devices. Devices that have different track 
capacities, for example, 3350 and 3380. 


used tracks. Tracks from the beginning of data sets to 
the last-used track (as indicated in the DS!ILSTAR field 
of the Format | DSCB). 


V 


VDRL. Volume restore limits. 
VDSS. YVTOC Data Set Services. 


virtual storage access method (VSANI). An access 
method for direct or sequential processing of fixed and 
variable-length records on direct access devices. The 
records ina VSAM data set or file can be organized in 
logical sequence bv a kev field (key sequence), in the 
physical sequence in which they are written on the data 
set or file (entry-sequence), or by the relative-record 
number. 


VM. Virtual machine. 
VOLID. Volume ID. 


VOLSER. Volume serial number. 


volume backup. Backup of an entire volume to protect 
against the loss of the volume. 


volume header record. The record in the DFDSS dump 
tape that identifies and contains data pertinent to the 
whole volume, and identifies the type of operation that 


created a dump. 


volume trailer record. The record in the DFDSS dump 
tape that identifies the end of the data fora DASD 
volume. | 


VSAM. Virtual storage access method. 


VSAM volume data set (VVDS). A data set that 
describes the VSAM and SMS-managed non- VSAM 
data sets on a volume. The name of the data set is 
SYSIL.VVDS. Vvolser. 

VSE. Virtual storage extended. 

VTOC. Volume table of contents. 

VTOCIX. The data set on which the location or the 
Format | DSCBs of the VTOC are kept in an index for 
quick access by DADSM. The name of the data set is 
SYS1.VTOCIX. Vvolser. 

VVDS. VSAM volume data set. 


VVR. VSAM volume record. 


W 


WAIT. In diagnosing program failures, the keyword 
that identifies DFDSS suspended activity, while waiting 
for some condition to be satisfied. DFDSS does not 
issue a Message to tell why it is waiting. 


WTO. Write to operator 


X 


XA. Extended Architecture. 
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